Agent skill · Understand Anything
/understand-diff See what a change affects before you merge it
understand-diff compares your current changes or a pull request with the saved knowledge graph. It finds the nodes behind each changed file, follows their direct connections to list what might break, notes which architectural layers are crossed and gives a risk assessment. It also writes an overlay so the dashboard can highlight changed and affected parts.
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 are about to commit and want to know which callers a change could break.
- You are reviewing a pull request in a part of the codebase you do not know.
- You want a visual view of a change's reach in the dashboard.
How it works
- 1Collect changed files
The agent lists files from the working tree, the branch compared with main, or a named pull request before opening the graph.
- 2Check graph freshness
It compares the graph's commit with HEAD for this project only and warns if recent changes may be missing from the graph.
- 3Find nodes and neighbours
It greps the graph for nodes in the changed files, then follows one hop of edges to find upstream callers and downstream dependencies.
- 4Assess and overlay
It reports changed and affected components, layers touched and risk from complexity and blast radius, then writes diff-overlay.json for the dashboard.
What it steers the agent away from
- Loading the whole graph into context instead of searching it
- Trusting a stale graph without warning
- Reviewing a diff with no view of its dependents
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
Do I need to run /understand first?
Yes. Without a saved graph the skill stops and asks you to build one.
Should the overlay file be committed?
No. The README lists diff-overlay.json as local scratch to keep out of version control.
More guides from Understand Anything
/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 →/understandMap a whole codebase into a searchable knowledge graphScans a codebase with parallel subagents and saves a knowledge graph of files, symbols, layers, a guided tour and per-file lessons.Read the guide →
Also in this pack
/understand-chatAnswers questions about a codebase by grepping the graph for matching nodes and following their edges.↗/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-diff by EgonexAI (MIT); read the full, current text there.