Understand Diff

This analyzes your git diffs against a pre-built knowledge graph to show you not just what changed, but what else might break. It greps through the graph JSON to find nodes for your changed files, traces their edges to identify upstream callers and downstream dependencies, then gives you a structured breakdown of affected components, architectural layers touched, and a risk assessment based on complexity scores and blast radius. The smart part is it doesn't load the entire graph into context, it searches efficiently. You need to run the understand skill first to generate the graph, then this becomes useful during code review or before merging branches. Outputs a diff overlay JSON that the dashboard can visualize.

skills.sh installs: 4K
GitHub stars: 91.8K
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add egonex-ai/understand-anything --skill understand-diff --agent claude-code

Installs into .claude/skills of the current project.

Files

/understand-diff

Analyze the current code changes against the knowledge graph in the project's data directory (.ua/knowledge-graph.json, or the legacy .understand-anything/knowledge-graph.json when that directory is present).

Graph Structure Reference

The knowledge graph JSON has this structure:

project — {name, description, languages, frameworks, analyzedAt, gitCommitHash}
nodes[] — each has {id, type, name, filePath?, summary, tags[], complexity, languageNotes?}
- Code node types: file, function, class, module, concept
- Non-code node types: config, document, service, table, endpoint, pipeline, schema, resource
- Domain/knowledge node types: domain, flow, step, article, entity, topic, claim, source
- IDs use the node type as prefix, e.g. file:path, function:path:name, config:path, article:path
edges[] — each has {source, target, type, direction, weight}
- Key types: imports, contains, calls, depends_on, configures, documents, deploys, triggers, contains_flow, flow_step, related, cites
layers[] — each has {id, name, description, nodeIds[]}
tour[] — each has {order, title, description, nodeIds[]}