understand-chat

Answers codebase questions by querying a JSON knowledge graph of files, functions, and dependencies.

Updated Jun 28, 2026
One-click install
npx skills add https://github.com/AO-HyS/aohys.com --skill understand-chat-ao-hys
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: understand-chat
Source: https://github.com/AO-HyS/aohys.com/tree/main/.agents/skills/understand-chat
Command: npx skills add https://github.com/AO-HyS/aohys.com --skill understand-chat-ao-hys

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Navigating an unfamiliar codebase is slow when you must read files one by one. This Skill answers questions about a codebase by searching a pre-built knowledge graph, so you get targeted answers about files, functions, classes, and their relationships without loading the entire repository into context. ## Core Features & Use Cases - Graph-Based Code Search: Queries the knowledge graph at .understand-anything/knowledge-graph.json for nodes (files, functions, classes, modules, concepts) matching your question by name, summary, or tags. - Dependency Tracing: Follows edges such as imports, calls, contains, and depends_on to show the 1-hop subgraph around any matched component, revealing upstream callers and downstream dependencies. - Architectural Context: Reads layer definitions to explain which architectural layers the relevant code belongs to and why. - Use Case: Ask "Where is authentication handled and what depends on it?" and receive an answer citing specific files, functions, and their import/call relationships, plus the architectural layer involved. ## Quick Start Ask a question about the codebase, such as "How does the contact form submission flow work?", and the Skill will search the knowledge graph and answer with specific file and function references.

Frequently Asked Questions about understand-chat

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I ask questions about a codebase without reading every file?▼

Use a knowledge graph of the codebase and search it for nodes matching your query keywords. This Skill greps the graph's name, summary, and tags fields, then follows edges to answer with specific file and function references.

How to find what depends on a function or module in a codebase?▼

Search the knowledge graph edges for the node's ID to find incoming imports and calls (upstream) and outgoing dependencies (downstream). This gives you the 1-hop subgraph showing exactly how components connect.

What is a code knowledge graph and what does it contain?▼

It is a JSON file with project metadata, nodes (files, functions, classes, modules, concepts with summaries and tags), edges (imports, contains, calls, depends_on), architectural layers, and a guided tour of the codebase.

Why does the skill say to run /understand first?▼

The chat skill requires an existing knowledge graph at .understand-anything/knowledge-graph.json. If that file is missing, the graph has not been generated yet, so you must run the /understand skill to build it before querying.

What are the limitations of querying a static knowledge graph?▼

The graph reflects the codebase at the commit it was generated, so recent changes may be missing. It also cannot answer questions about runtime behavior or code not captured as nodes and edges during analysis.