Understand — Codebase Knowledge Graph Builder
Scans a repository and produces an interactive knowledge graph of its architecture, components and relationships.
Dev & CodingIntermediate★ 78,314⑂ 6,578AI score 8/10Last updated: Jul 30, 2026
What it does
Running /understand analyzes the current (or a specified) repository and writes .ua/knowledge-graph.json, the data file behind an interactive architecture dashboard. It follows a disciplined 7-phase pipeline:
- Phase 0–1: resolve project root, handle git worktrees, generate
.understandignore, scan files, languages and frameworks - Phase 1.5–2: compute semantic batches, then run up to 5 file-analyzer subagents in parallel to emit nodes/edges, with ID normalization, dedup and dangling-edge pruning
- Phase 3–4: review the assembled graph and derive architectural layers using directory structure plus language/framework addenda
- Supports incremental updates (re-analyzes only files changed since the last commit hash) and localized output via
--language <code>.
Who it's for
- Developers onboarding onto an unfamiliar or large codebase
- Tech leads who need a dependency map of a legacy system
- Anyone who wants a first draft of architecture documentation generated automatically
Examples
/understand --full— force a complete rebuild of the knowledge graph for the current repo./understand ../legacy-api --exclude "tests/*,docs/*"— analyze another directory while skipping tests and docs./understand --auto-update— enable graph refresh on commit so only changed files are re-analyzed.
· · · Install guide · · ·
Install in the Claude app (no terminal)
- Download the ZIP with the button below.
- In Claude, open Settings → Capabilities and turn on 'Code execution and file creation'. (one time)
- Go to Customize → Skills → + → 'Upload a skill' and upload the ZIP.
Install in Claude Code
Let Claude do it — paste this into Claude Code
Install the skill I found on Claude Skill Mart. Copy the understand-anything-plugin/skills/understand folder from the GitHub repo Egonex-AI/Understand-Anything into my ~/.claude/skills/understand/. When it's done, tell me in one line what this skill can do.
Install with a command instead
git clone https://github.com/Egonex-AI/Understand-Anything.git ~/understand-anything && cd ~/understand-anything && pnpm install && pnpm --filter @understand-anything/core build && mkdir -p ~/.claude/skills && cp -r understand-anything-plugin/skills/understand ~/.claude/skills/understand⚠ This is a third-party skill. Check the source repository before installing.
- Prerequisites: install Node.js ≥ 22 and pnpm ≥ 10 (verify with
node -vandpnpm -v). - Clone the repo:
git clone https://github.com/Egonex-AI/Understand-Anything.git ~/understand-anything - Build the core package:
cd ~/understand-anything && pnpm install && pnpm --filter @understand-anything/core build - Install the skill:
mkdir -p ~/.claude/skills && cp -r understand-anything-plugin/skills/understand ~/.claude/skills/understand - Restart Claude Code, open the project you want to analyze, and run
/understand. - On first run the skill creates
.ua/.understandignoreand waits for your confirmation — review the exclusion list, then confirm to continue. - For repos with more than 100 files, scope the run (e.g.
/understand src) to keep analysis time and token usage manageable.
View source on GitHub ↗License: MIT