Content
88%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 dense, disciplined instruction body that encodes TDD as enforceable gates: an explicit hard gate, a numbered rule with red/green checkpoints, a quantified consolidation protocol with a required ledger, and a rotation heuristic for stuck cycles. Its only weaknesses are implicit output formats (no ledger example) and references to files that do not exist in this skill's bundle.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean throughout: it assumes Claude already knows TDD and adds only policy — 'If a test passes before implementation, it is not red evidence', 'Review a slowdown only when it exceeds both 20 percent and 100 ms'. There is no padding, no conceptual explanation of what tests or refactoring are, and every sentence constrains behavior. | 5 / 5 |
Actionability | Guidance is highly concrete for an instruction-only skill: a numbered six-step rule, named ledger fields ('old_test', 'behavior', 'replacement', 'mutant', 'red_observed', 'baseline_ms', 'candidate_ms', 'reason'), and exact measurement protocol (one warm-up, five isolated runs, median). It stops short of a 5 because no example of the ledger or a red-evidence record is given, so the exact output format is left implicit. | 4 / 5 |
Workflow Clarity | The sequence is explicit with validation checkpoints at each gate: run the focused test and record the expected failure and exit status, implement only after red, run the focused test then the affected suite, refactor only while green. Feedback loops are present — repairing a test that errors 'until it fails on the missing behavior', and stopping after two failed attempts to re-check the boundary — satisfying the rubric's error-recovery requirement. | 5 / 5 |
Progressive Disclosure | The skill is a short, single file with well-organized sections (rule, consolidation, strategy rotation) and no bundle directory, so there is nothing that should be split out. It loses a point because the body references files that are not part of this skill's bundle — 'skills/blocks/engineering-method-selection.md' and 'THIRD_PARTY_NOTICES.md' — leaving two dangling paths a reader cannot resolve locally. | 4 / 5 |
Total | 18 / 20 Passed |