Agent skill · Understand Anything
/understand Map a whole codebase into a searchable knowledge graph
The understand skill runs a staged pipeline that turns a project into a knowledge graph saved as .ua/knowledge-graph.json. Tree-sitter extracts structure, subagents write summaries, layers and a dependency-ordered tour, and validation checks the result before saving. Later runs update only files with structural changes, and the dashboard opens when the graph passes validation.
Works with
- Claude Code
- Codex, Gemini CLI, OpenCode, Cline, Kiro, Trae and other agents
- Windows
- VS Code + GitHub Copilot
- Copilot CLI
- Devin
Used forDiagrams and codebase maps
When to use it
- You have joined a project and need a map of its architecture before reading code.
- You want a graph your team can commit so others skip the analysis.
- You want the graph refreshed automatically after each commit.
How it works
- 1Pre-flight
The agent resolves the project root, redirects output out of temporary git worktrees, builds the plugin core if needed and decides between a full, incremental or review-only run.
- 2Scan and batch
It writes a starter .understandignore for you to confirm, inventories files with categories and imports, warns above 100 files and groups files into batches.
- 3Analyse in parallel
It dispatches up to five file-analyzer subagents at a time, then merges, normalises and deduplicates their nodes and edges with bundled scripts.
- 4Layers and tour
Separate agents assign architectural layers and write a guided tour plus per-file code lessons, with language and framework notes injected into their prompts.
- 5Validate and save
It checks graph integrity, or runs a full LLM review with --review, writes fingerprints and metadata for incremental updates, and reports what it built.
What it steers the agent away from
- Re-analysing an unchanged project and spending tokens for nothing
- Losing the graph when the agent works inside a disposable worktree
- Silently dropping failed phases instead of reporting them
Install this skill
It installs with the Understand Anything pack.
Claude CodeInstalls the native plugin, including its analysis subagents and hooks.
/plugin marketplace add Egonex-AI/Understand-Anything
/plugin install understand-anythingCodex, Gemini CLI, OpenCode, Cline, Kiro, Trae and other agents (macOS/Linux)Downloads a copy into ~/.understand-anything/repo and links the skills for the chosen platform; in Codex, invoke skills with $ instead of /.
curl -fsSL https://raw.githubusercontent.com/Egonex-AI/Understand-Anything/main/install.sh | bash
curl -fsSL https://raw.githubusercontent.com/Egonex-AI/Understand-Anything/main/install.sh | bash -s codexWindows (PowerShell)The same installer for Windows, with its own update and uninstall switches.
iwr -useb https://raw.githubusercontent.com/Egonex-AI/Understand-Anything/main/install.ps1 | iexVS Code + GitHub CopilotCopilot in VS Code 1.108 or later can also pick the plugin up automatically from a cloned repo.
/plugin marketplace add Egonex-AI/Understand-Anything
/plugin install understand-anything@understand-anythingCopilot CLIInstalls the plugin folder directly from GitHub.
copilot plugin install Egonex-AI/Understand-Anything:understand-anything-pluginDevinThe plugin route gives namespaced skills and auto-update hooks; an optional MCP server can serve existing graphs.
devin auth login # plugin management requires sign-in
devin plugins install Egonex-AI/Understand-Anything#understand-anything-pluginCommands come from the author’s README; check it for changes before you run them.
Questions
Can I limit it to part of a monorepo?
Yes. Pass a subdirectory path, or use --exclude with glob patterns that take priority over the ignore file.
Can the summaries be in another language?
Yes. --language sets the language for summaries, tour text and dashboard labels, and the choice is stored for later runs.
More guides from Understand Anything
/understand-diffSee what a change affects before you merge itMaps current changes or a pull request to graph nodes, lists affected components and layers, and rates the risk.Read the guide →/understand-domainExtract the business flows hidden in your codePulls business domains, flows and process steps out of the code and shows them as a horizontal flow graph.Read the guide →
Also in this pack
/understand-explainExplains one file, function or module in depth, using the graph to show what it depends on and what calls it.↗/understand-figmaReads a Figma file through its REST API and graphs pages, screens, components, instances and design tokens.↗/understand-knowledgeTurns a Karpathy-style markdown wiki into a graph of articles, entities, claims and topic clusters.↗/understand-onboardWrites an onboarding guide for new team members from the graph's layers, tour and complexity hotspots.↗
Summary by trendhub. The skill itself lives in Egonex-AI/Understand-Anything/understand-anything-plugin/skills/understand by EgonexAI (MIT); read the full, current text there.