code-understand Skill
✓ VerifiziertErstellt Karten von kritischen Dateien, Symbolen, Callern und Abhängigkeiten, um Orientierung in der Architektur zu bieten und Impact-Analysen durchzuführen.
- GitHub Stars
- 3.716
- Dateien
- 1
- Letzter Commit
- 11. Nov. 2026
- Lizenz
- MIT
- Erlaubte Tools
- —
Was macht der code-understand Skill?
Erstellt Karten von kritischen Dateien, Symbolen, Callern und Abhängigkeiten, um Orientierung in der Architektur zu bieten und Impact-Analysen durchzuführen.
Zusammenfassung erzeugt aus der SKILL.md des Skills.
Über den code-understand skill
Dieses Skill ermöglicht es dir, dich in unbekannten Codebases zurechtzufinden, indem es die wichtigsten Dateien und Symbol-Abhängigkeiten identifiziert. Entwickler nutzen es, um eine Focus Map zu erstellen, die die wichtigsten Symbole nach Relevanz rankt und Dateinamen sowie Zeilennummern angibt, um die Orientierung vor Änderungen zu erleichtern. Es ist konzipiert für die Architektur-Orientierung, Impact-Analysen und die Bestimmung des Blast Radius einer spezifischen Code-Änderung.
Ein Agent sollte dieses Tool laden, wenn ein User fragt, wie eine bestimmte Funktion arbeitet, wer ein bestimmtes Modul aufruft oder was bei einem Refactor kaputtgehen könnte. Das Tool nutzt verschiedene Backends und bevorzugt CodeGraph für strukturelle Call-Graph-Edges, kann aber auch einen dependency-freien, eingebauten Extractor oder einen bestehenden Graphify-Graph verwenden. User können die Analyse starten, indem sie spezifische Dateien über das --changed Flag angeben oder Änderungen seit einem bestimmten git SHA targeten.
Das Tool liefert eine gerankte Liste von Symbolen statt des eigentlichen Quellcodes und dient somit als Leitfaden dafür, wo man als Nächstes lesen sollte. Es ist als temporärer Beschleuniger für die unmittelbare Arbeit gedacht und sollte nicht verwendet werden, um permanente Dokumentationen oder Wiki-Einträge zu erstellen.
Was ein agent damit machen kann
- 1Refactoring-Impact analysierenBestimme den Blast Radius einer Änderung, indem du die Abhängigkeiten spezifischer Dateien analysierst.
- 2Function Caller identifizierenFinde heraus, welche anderen Teile der Codebase eine bestimmte Funktion oder ein Modul nutzen.
- 3Orientierung in neuen ModulenErstelle eine Karte der Architektur eines unbekannten Moduls, bevor du versuchst, dessen Struktur zu bearbeiten.
Geschrieben basierend auf dem SKILL.md des skills. Jeder use case wurde gegen ein zitat daraus geprüft.
So installierst du den code-understand Skill
Jeder Befehl kopiert den Skill-Ordner in das Skills-Verzeichnis des Clients. Starte den Client neu oder beginne eine neue Session, um ihn zu laden.Den code-understand Skill in Plugin installieren
/plugin marketplace add Ar9av/obsidian-wiki /plugin install obsidian-wiki@obsidian-wiki
Den code-understand Skill in Claude Code installieren
~/.claude/skills/code-understand/SKILL.md
$ npx degit Ar9av/obsidian-wiki/skills/code-understand ~/.claude/skills/code-understandDen code-understand Skill in Claude Code (project) installieren
.claude/skills/code-understand/SKILL.md
$ npx degit Ar9av/obsidian-wiki/skills/code-understand .claude/skills/code-understandDen code-understand Skill in Codex installieren
~/.agents/skills/code-understand/SKILL.md
$ npx degit Ar9av/obsidian-wiki/skills/code-understand ~/.agents/skills/code-understandDen code-understand Skill in Gemini CLI installieren
~/.gemini/skills/code-understand/SKILL.md
$ npx degit Ar9av/obsidian-wiki/skills/code-understand ~/.gemini/skills/code-understandDen code-understand Skill in Claude.ai installieren
npx degit Ar9av/obsidian-wiki/skills/code-understand code-understand && zip -r code-understand.zip code-understand # claude.ai → Customize → Skills → + → Create skill → Upload a skill → code-understand.zip
Automatisierte Checks
Geluften am 15. Nov. 2026Vollständiger Bericht →Hat unsere automatischen Prüfungen bestanden. Das ist kein Sicherheitsaudit: Lesen Sie die Skripte, bevor ein Agent sie ausführt. Wie die Checks funktionieren
- Source Repository verknüpft und erreichbarar9av/obsidian-wiki/skills/code-understand is public and reachablegithub.com/ar9av/obsidian-wiki/tree/HEAD/skills/code-underst ↗Bestanden
- Open Source Lizenz (OSI)MITspdx.org/licenses/MIT.html ↗Bestanden
- Commit oder Release im letzten JahrLast commit 2026-11-11github.com/ar9av/obsidian-wiki/commits ↗Bestanden
- Keine Download-und-Ausführen-Muster oder Zugangsdatendiebstahl in SkriptenNo scripts in the skill folderBestanden
- Keine versteckten Anweisungen in SKILL.mdNo override phrases, safeguard switches, credential requests or hidden charactersgithub.com/ar9av/obsidian-wiki/blob/HEAD/skills/code-underst ↗Bestanden
- Vorab erlaubte Tools sind eingeschränktNo pre-approved tools; the agent asks before using onegithub.com/ar9av/obsidian-wiki/blob/HEAD/skills/code-underst ↗Bestanden
- SKILL.md folgt dem Agent-Skills-FormatValid name and description; says when to use it; 84 linesgithub.com/ar9av/obsidian-wiki/blob/HEAD/skills/code-underst ↗Bestanden
SKILL.md
Auf GitHub ansehenCode Understand — On-Demand Architecture Focus Map
You are about to work in a codebase you don't fully know yet. Instead of grepping around or
reading files at random, ask the local extractor for a focus map: the ranked symbols the
architecture hangs on, each with a file:line citation and evidence type. Read only what it
points at — this is a map, not a substitute for reading the actual code it cites.
When to reach for this
- Before editing an unfamiliar module — see what calls it and what it calls before changing its shape.
- The user asks "how does X work", "what's the impact of changing Y", "who else uses this function" for a codebase, not the wiki.
- You're about to do a large refactor and want a ranked list of load-bearing files instead of reading the whole tree.
- You already have a diff or a set of changed files and want to know their blast radius before finishing the change.
Not for: summarizing what a project does for the wiki (that's wiki-update Step 3b, which
calls this same command as part of a bigger sync flow) — use this skill directly only when you
need the focus map for your own immediate work, not to persist knowledge.
Running it
obsidian-wiki code-understand --project <dir> [--backend auto|builtin|codegraph|graphify] \
[--changed <file>...] [--since <sha>] [--max-symbols N] [--pretty]
--project— defaults to the current directory.- No
--changed/--since— seeds from every tracked file (full-project scan). --changed <file>(repeatable) — seed from specific files you already know are relevant (e.g. files in the diff you're about to make).--since <sha>— seed from everything changed since a git ref (e.g.--since HEAD~5or a base branch).--backend—auto(default) uses CodeGraph when installed, then an existing Graphify graph (graphify-out/graph.json, read only — never rebuilt), and falls back to the builtin extractor otherwise; forcebuiltinfor the dependency-free path,codegraphto require the enhanced backend (fails loudly if it's not installed rather than silently degrading), orgraphifyto require the Graphify graph.--max-symbols— cap the focus map size (default 50); keep this small for a quick orientation pass, raise it for a thorough one.
GUARD: if the command is unavailable or errors, skip it and fall back to your normal exploration (grep/read) — this is an accelerant, not a dependency. Don't block work on it.
Reading the output
- Evidence type matters. When
backend: codegraph, focus-map entries are structural facts (real call-graph edges) — cite them directly. Whenbackend: builtin,defines/imports/changed-fileentries are facts, butrg-referenceentries are text-match evidence only — open the file and confirm before treating it as a real relationship. - Open what it cites, nothing else first. The focus map tells you where to read; it
never contains source bodies. Go read those
file:linelocations before forming an opinion on the architecture. - Cite it in your own output. If you explain the architecture back to the user or write
it into a PR description/commit message, keep the
(file:lines)citations from the focus map or from the source you opened — don't assert structure without a pointer to it. - It's a cache, not a deliverable. Never write the raw JSON or
.codegraph/into the wiki vault, a PR description, or committed docs — it's a disposable sidecar in the project repo (git-ignored). Re-run it fresh next time rather than treating old output as durable.
If CodeGraph isn't installed
auto/builtin still work with zero setup (uses the regex AST extractor + rg). If you want
the enhanced cross-file call-graph evidence and the user is fine with installing something:
npm install -g @colbymchenry/codegraph
or point CODE_UNDERSTANDING_CODEGRAPH_BIN at an existing binary. Never install without the
user's go-ahead — ask first, then re-run the command.
Check obsidian-wiki doctor --project <dir> for the code-understanding.* capability lines
(builtin, rg, codegraph, codegraph-index, codegraph-fresh, codegraph-gitignore) to
see what's available before deciding which backend to request explicitly.
Dateien in diesem Skill
1code-understand Skill-Fragen
Wie installiere ich den code-understand Skill in Claude Code?
Führe npx degit Ar9av/obsidian-wiki/skills/code-understand ~/.claude/skills/code-understand aus. Claude Code lädt Skills aus ~/.claude/skills (alle Projekte) oder .claude/skills (ein Projekt) und nutzt einen Skill, wenn seine Beschreibung zur Aufgabe passt.
Welche Clients können den code-understand Skill nutzen?
Jeder Client, der das Agent Skills-Format liest: Claude Code, Codex, Gemini CLI und claude.ai (als ZIP hochladen). Skripte im Skill laufen nur dort, wo der Client Codeausführung erlaubt.
Wann sollte ich das code-understand Skill nutzen?
Nutze es vor dem Bearbeiten unbekannter Module, bei großen Refactors oder wenn du verstehen musst, welche Auswirkungen eine Änderung hat oder wer die Caller einer bestimmten Funktion sind.