Content
92%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 well-sequenced, highly actionable workflow: concrete shell and git commands, exact graph fields to extract, explicit freshness validation with graceful non-blocking fallbacks, and a clear output template. Only minor tightening of the freshness-check prose is possible.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and assumes Claude's competence — it documents only the project-specific graph schema and gives terse operational directives with no filler — but the freshness-check prose in step 2 and the triple node-type enumeration could be trimmed slightly, matching anchor 4 rather than anchor 5's every-token-earns-its-place standard. | 4 / 5 |
Actionability | Every step is executable: a copy-paste shell one-liner for resolving $UA_DIR, a complete copy-paste git validation block, exact JSON keys to Grep ("project", "layers", "tour"), the exact node types and fields to extract, and a named section template for the output guide — matching anchor 5 ("copy-paste ready code or commands"). | 5 / 5 |
Workflow Clarity | Eleven clearly sequenced steps with explicit validation checkpoints and error-recovery fallbacks: step 1 verifies knowledge-graph.json exists and tells the user to run /understand if not; step 2 resolves the graph commit, checks staleness with concrete diffs, and degrades gracefully when git metadata is missing or invalid — matching anchor 5. | 5 / 5 |
Progressive Disclosure | No bundle files exist (references/, scripts/, assets/ are absent) and none are needed; the ~65-line body is cleanly organized into Graph Structure Reference, How to Read Efficiently, and Instructions, with all content appropriately inline for a skill of this size — matching the well-organized-structure criterion for anchor 5. | 5 / 5 |
Total | 19 / 20 Passed |