Content
82%Weight 40%Scale 1-5Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The body is a strong, self-contained instruction document: fully executable commands with documented flags, explicit failure fallback, and evidence-type interpretation rules. It would benefit only from tightening the redundant intro/purpose statements and making the run-order (doctor check before backend choice) more explicit.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and assumes competence (no concept explanations, direct commands), but the opening paragraph and "When to reach for this" partially restate each other, and aphoristic guards ("a map, not a substitute...", "an accelerant, not a dependency") repeat the same idea — a few trims short of anchor 5's every-token-earns-its-place. | 4 / 5 |
Actionability | The main command is copy-paste ready with every flag documented ("--project", "--changed", "--since", "--backend", "--max-symbols"), plus concrete install ("npm install -g @colbymchenry/codegraph"), env-var override ("CODE_UNDERSTANDING_CODEGRAPH_BIN"), and a diagnostic ("obsidian-wiki doctor") — fully executable guidance covering the common cases, matching anchor 5. | 5 / 5 |
Workflow Clarity | The sequence (decide when → run command → interpret output by evidence type → open cited locations → cite in output) is clear with explicit error handling ("if the command is unavailable or errors... fall back to your normal exploration") and a verification step ("open the file and confirm before treating it as a real relationship"). It sits at anchor 4 because the overall ordering is conveyed across sections rather than as one explicit sequence — e.g., the doctor capability check appears after the install discussion, not as a step. The skill is read-only, so the destructive/batch validation cap does not apply. | 4 / 5 |
Progressive Disclosure | The ~76-line body is well-sectioned (When to reach for this / Running it / Reading the output / If CodeGraph isn't installed) with no nested or buried references — the only cross-skill mention (wiki-update) is clearly contextual. No bundle files exist and nothing inlined clearly belongs in a separate file, but at >50 lines with all content inline it fits anchor 4's "good structure; minor organization gaps" rather than the sub-50-line case the guideline exempts for a top score. | 4 / 5 |
Total | 17 / 20 Passed |