understand-explain

Explains a file, function, or module using a codebase knowledge graph and source analysis.

Updated Aug 26, 2026
One-click install
npx skills add https://github.com/danieliudi/trackforge-os --skill understand-explain-danieliudi
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: understand-explain
Source: https://github.com/danieliudi/trackforge-os/tree/main/.cursor/skills/understand-explain
Command: npx skills add https://github.com/danieliudi/trackforge-os --skill understand-explain-danieliudi

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Understanding an unfamiliar component in a large codebase requires manually tracing imports, callers, and architectural context. This Skill automates that investigation by querying a pre-built knowledge graph and reading the actual source to produce a deep-dive explanation of any file, function, or module. ## Core Features & Use Cases - Graph-Grounded Exploration: Searches the knowledge graph JSON for the target node, its connected edges (imports, calls, depends_on), and its architectural layer before reading code. - Freshness Validation: Compares the graph's recorded git commit against HEAD and working-tree changes, warning when graph-derived context may be stale. - Contextual Explanation: Describes the component's role, internal structure, external connections, and data flow in language accessible to readers unfamiliar with the programming language. - Use Case: A developer joins a monorepo and needs to understand what src/auth/login.ts:verifyToken does, who calls it, and which layer it belongs to — the Skill traces the graph neighborhood and explains it end to end. ## Quick Start Ask the assistant to run /understand-explain with a file path or function reference such as src/auth/login.ts:verifyToken to get a full architectural explanation.

Frequently Asked Questions about understand-explain

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

FAQPage Schema
How do I get an explanation of a specific function in my codebase?

Run the skill with a file path or function reference like src/auth/login.ts:verifyToken. It searches the knowledge graph for the node, traces its incoming and outgoing edges, reads the source file, and explains the component's role, connections, and data flow.

What is a knowledge graph JSON and how is it structured?

The knowledge graph JSON contains a project object, typed nodes (file, function, class, module, config, and more), typed edges (imports, calls, depends_on, contains), architectural layers, and guided tours. Node IDs use the type as a prefix, such as file:path or function:path:name.

What happens if the knowledge graph is out of date?

The skill compares the graph's recorded git commit hash against HEAD and checks committed, staged, and untracked changes scoped to the project. If project files changed since graph generation, it warns that context may be stale and suggests regenerating the graph.

Why does the skill say to run /understand first?

The explanation depends on an existing knowledge-graph.json in the .ua or .understand-anything directory. If that file is missing, there is no graph to query, so the /understand skill must generate it before explanations can be produced.

Can it explain code in a language I do not know?

Yes. The explanation step explicitly assumes the reader may not know the programming language, describing internal structure, external connections, and data flow in plain terms while highlighting patterns and idioms worth understanding.