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.
An exemplary lean debugging workflow: a numbered, well-sequenced procedure with genuine validation checkpoints (reproduce-first, failing regression test, real-consumer verification) and an anti-rut feedback loop after three failed fixes. The only minor gap is that a few steps rely on directive phrasing rather than exact commands.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is ~27 lines of dense, imperative instructions with zero padding and no explanation of concepts Claude already knows ("Change no code before this command exists", "Fix the pattern, not the instance"). Every token earns its place, matching the 'lean and efficient; assumes Claude's competence' anchor. | 5 / 5 |
Actionability | Concrete details are present: the reproduce command flags ("--format json --quiet"), the cache path (".fallow/"), a pointer to test evidence ("docs/development/quality-gates.md"), and quantified directives ("3 to 5 ranked hypotheses", "After 3 failed fixes"). A few steps (reduce to a minimal fixture, trace through the pipeline layers) are directives without an exact command, which is the minor gap that separates this from anchor 5. | 4 / 5 |
Workflow Clarity | An explicit 8-step sequence with validation checkpoints throughout: reproduce before changing code (step 1), a regression test that must fail without the fix (step 6), real-consumer output comparison (step 7), and a review pass (step 8). It even includes an error-recovery feedback loop — "After 3 failed fixes, stop and write down the premise that they share. Question that premise before a fourth fix" — matching the top anchor's requirements. | 5 / 5 |
Progressive Disclosure | The skill is under 50 lines, has no bundle files, and needs no external references beyond a single well-signaled repo path (docs/development/quality-gates.md) used to justify a practice rather than park content. Per the rubric's simple-skill guidance, a short body with well-organized numbered structure scores 5; content is appropriately inline with nothing that belongs in a separate file. | 5 / 5 |
Total | 19 / 20 Passed |