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.
A high-quality process skill: the workflow is tightly sequenced with predict-run-verify checkpoints at every step, guidance is concrete (exact announcement strings, [TEST] comment format, worked example), and details are properly split into two real, one-level-deep reference files. The only trimmable content is the opening TDD-philosophy paragraph.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The Core Rules, Implementation Phase, and Final Evaluation are dense and prescriptive, but the opening paragraph explains TDD philosophy Claude already knows ("TDD is a design technique that uses tests as a tool. Design emerges from usage, not speculation..." and "it's crucial to be thorough and only add what tests demand") — minor over-explanation that could be trimmed. Not score 5, but well above anchor 3's "some unnecessary explanation" since the padding is confined to one paragraph. | 4 / 5 |
Actionability | Concrete, executable instruction throughout: exact announcement strings ("Using TDD skill in mode: [auto|human]", "Starting refactoring stage", "Refactoring complete"), a worked [TEST] comment example, the given-when-then test format, the two-step red phase, and a per-line justification question ("Does a failing test require this?"). Per the scoring notes, an instruction-only skill needs concrete guidance rather than code, and this delivers it; specific examples cover the common cases. | 5 / 5 |
Workflow Clarity | The sequence is explicit with validation checkpoints at every turn: predict-fail → run → observe → minimal fix (steps 3-10 of Implementation Phase), "Run all tests every time - Not just the one you're working on", "Run tests after each simplification", and feedback loops in Final Evaluation ("start the process for the missing tests from the beginning... go back to previous stages if needed"). This matches the anchor-5 pattern of explicit validation steps plus error-recovery loops; no destructive/batch cap applies. | 5 / 5 |
Progressive Disclosure | The body is a concise process overview with two well-signaled, one-level-deep references that both exist: "For layered architectures, see [boundary-testing.md](references/boundary-testing.md) for L3/L4 altitude testing, property-based tests with fast-check..." and "walk through [ZOMBIES](references/zombies.md)". Neither reference file nests further references, content is appropriately split, and navigation is easy. | 5 / 5 |
Total | 19 / 20 Passed |