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 process skill: a lean, well-sequenced red-green-refactor cycle with validation checkpoints and error-recovery loops at every step, plus an appropriately deferred single reference. The only minor gap is the absence of any concrete example (such as a sample failing test), which keeps actionability just short of full marks.
Suggestions
Add one short worked example of a failing test and the minimal code that makes it pass, to lift actionability from concrete guidance to copy-paste-ready.
Name how to find the project's test command (e.g., check package.json scripts / Makefile / CI config) in step 2 instead of the generic 'the project's test command'.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~25-line body is lean and assumes Claude's competence: no explanation of what TDD is or why it matters, no library tutorials, no padding. Phrases like "Write one test for one behavior" and "Add nothing the test does not need" earn their tokens; the one-line opening summary is orientation, not over-explanation, so the level-5 anchor fits better than level 4. | 5 / 5 |
Actionability | The guidance is directive and concrete — "Run the project's test command", "The test must fail because the behavior is missing, not because of a typo or a missing import", "If it passes, it tests nothing new: change the test" — with clear failure criteria and decision points. It sits at level 4 rather than 5 because there are no concrete examples or commands (e.g., a sample failing test or how to find the project's test command), a minor gap even for an instruction-only skill. | 4 / 5 |
Workflow Clarity | The five-step cycle is clearly sequenced with explicit validation checkpoints at every phase ("Watch it fail", "Watch it pass. Run the full suite", "Run the suite again" after refactor) and genuine feedback loops for error recovery ("If it passes... change the test"; code written before its test "is deleted and written again from the test"). This matches the level-5 anchor including its feedback-loop criterion. | 5 / 5 |
Progressive Disclosure | The body keeps only the cycle and rules inline, and defers test-writing detail to a single one-level-deep reference that is real (references/writing-good-tests.md) and clearly signaled with a conditional load cue ("When writing or changing a test, read..."). Structure and navigation match the level-5 anchor; nothing is inlined that belongs in a separate file. | 5 / 5 |
Total | 19 / 20 Passed |