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.
A well-crafted instruction-only skill body: a numbered workflow with a genuine troubleshooting/feedback section, highly specific tool guidance, and clean separation between overview and the real one-level reference file. The only trim opportunity is the mild repetition of the 'search before reading' rationale.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and dense with tool-specific facts Claude would not know (parameter defaults like 'minScore (default 0.10)', env vars, watcher modes), with no padding explaining concepts Claude already knows. It is not a 5 because the core 'search before reading' principle is restated in section 3 ('Never read a file just to find out if it's relevant') and the milliseconds/negligible-cost point from the intro is repeated ('in milliseconds... far cheaper than opening files speculatively'). | 4 / 5 |
Actionability | For an instruction-only skill the guidance is fully executable: exact tool names, concrete parameters ('fileFilter', 'languageFilter', 'minScore (default 0.10)', 'mode: "interactive"'), example queries ('how is authentication handled'), env-var conditions, and a Goal→Tool quick-reference table covering the common cases. Per the rubric's scoring note, absence of code is not penalized when the instruction guidance is this specific. | 5 / 5 |
Workflow Clarity | A clearly sequenced 1–6 workflow (search → graph before imports → read only after narrowing → context artifacts → status troubleshooting → about) with an explicit error-recovery section: 'If search returns no results, the project may not be indexed yet' and stale-result handling that routes to codebase_update, plus conditional watcher/git-mode checkpoints. These feedback loops match the 5 anchor. | 5 / 5 |
Progressive Disclosure | The SKILL.md body is a well-sectioned ~78-line overview that defers full parameter detail to a clearly signaled, one-level-deep reference ('For full parameter details on every tool, see [references/tool-reference.md]'), which exists in the bundle and contains exactly that per-tool parameter detail. Navigation is easy and nothing that belongs in the reference is inlined in bulk. | 5 / 5 |
Total | 19 / 20 Passed |