Content
93%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.
An exemplary skill body: lean, concrete, with verified copy-paste commands and well-signaled one-level-deep references that all exist in the bundle. The only notable gap is that the fix/intervention half of the workflow lacks explicit per-fix validation steps in the main body, though triage itself is rigorously sequenced.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~64-line body is lean and table-driven with a one-sentence core principle and no explanations of concepts Claude already knows; the only redundancy is the rewrite rule repeated between the intro and 'Do not'. It matches anchor 5 ('Lean and efficient; assumes Claude's competence; every token earns its place') since that single repetition is not over-explanation. | 5 / 5 |
Actionability | Both deno commands are copy-paste ready and exactly match the bundled scripts' documented usage (verified against recipe-scaffold.ts and coverage-audit.ts), and the diagnostic steps are concrete heuristics ('Read 3 random recipes and match them to the states', 'Read the first sentence of each paragraph. It must stand alone'). This matches anchor 5 ('Fully executable; copy-paste ready code or commands; specific examples cover the common cases'). | 5 / 5 |
Workflow Clarity | A clear 7-step numbered diagnose sequence with per-step pass criteria ('Headings must tell the story', 'It must stand alone') and a session-end feedback loop with escalation ('Did this solve what you were trying to do?' plus issue filing). It is not a 5 because the fix/intervention phase has no per-fix validation loop in the body; the non-destructive, read-only nature of the operations means the destructive/batch cap does not apply. | 4 / 5 |
Progressive Disclosure | The body is a clear overview with five purpose-labeled, one-level-deep reference pointers ('For expanded symptoms, questions, and interventions, load `references/states.md`' and four others), all verified to exist in references/, plus two bundled scripts. This matches anchor 5 ('Clear overview with well-signaled one-level-deep references; content appropriately split; easy navigation'). | 5 / 5 |
Total | 19 / 20 Passed |