Content
81%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 highly actionable, strongly sequenced TDD discipline skill with explicit validation checkpoints, error-recovery loops, and a real, well-signaled reference file. Its main weakness is token efficiency: the no-code-without-failing-test rule is hammered across four overlapping sections with several duplicated entries.
Suggestions
Merge the 'Common Rationalizations' table and 'Red Flags' list into a single section — entries like 'Keep as reference', 'deleting is wasteful', 'TDD is dogmatic', and 'spirit not ritual' appear in both, so consolidating removes ~30 lines of duplication.
Trim the multi-sentence 'Reality' rebuttals in the Rationalizations table to one-line answers, or move the longer arguments into references/writing-good-tests.md.
Replace the graphviz digraph with a short text cycle (RED -> verify fail -> GREEN -> verify pass -> REFACTOR -> repeat) since the diagram duplicates the sequenced section headers that immediately follow it.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Per-line the body is punchy and imperative, but the core rule is restated across four sections (Iron Law, Common Rationalizations, Red Flags, Final Rule), and several items appear near-verbatim in both the Rationalizations table and the Red Flags list ('Keep as reference', 'Deleting X hours is wasteful', 'TDD is dogmatic', 'spirit not ritual'). This systematic duplication exceeds the 'minor instances of over-explanation' of anchor 4 and fits anchor 3: mostly efficient but includes content that could be tightened. | 3 / 5 |
Actionability | Fully executable guidance throughout: concrete TypeScript test and implementation examples, exact commands ('npm test path/to/test.test.ts'), paired Good/Bad examples, and a complete worked bug-fix example showing expected FAIL and PASS output. It is not anchor 4 because the examples cover the common cases (feature via retry, bug fix via form validation) without meaningful gaps. | 5 / 5 |
Workflow Clarity | The RED -> Verify RED -> GREEN -> Verify GREEN -> REFACTOR -> Repeat cycle is explicitly sequenced with mandatory verification commands at each phase, error-recovery feedback loops ('Test errors? Fix error, re-run until it fails correctly'; 'Test fails? Fix code, not test'), and a pre-completion checklist. The destructive-operation cap does not apply because validation steps are present and explicit. | 5 / 5 |
Progressive Disclosure | One reference file is clearly signaled and real ('read [references/writing-good-tests.md] for the rules that keep tests honest') with a bullet summary of its contents, one level deep — good structure. Not anchor 5 because the ~315-line SKILL.md retains substantial inline material (the rationalization rebuttal table, the graphviz cycle diagram) that arguably belongs in the reference file. | 4 / 5 |
Total | 17 / 20 Passed |