Understand Diff

This one analyzes git diffs against your project's knowledge graph to show you not just what changed, but what might break. It greps through the graph JSON to find nodes for your modified files, traces their edges to find upstream callers and downstream dependencies, and flags which architectural layers you're touching. The risk assessment pulls from node complexity and the blast radius of affected components. Honestly most useful when you're reviewing someone else's PR and need to quickly understand the ripple effects without reading every file. It writes a diff overlay JSON that the dashboard can visualize, which beats staring at a wall of grep output.

skills.sh installs: 1.1K
GitHub stars: 73.8K
last updated: Jul 14, 2026

View on GitHub

Install

$ npx -y skills add lum1104/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[]}