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 SKILL.md body: a crisp five-step cycle with genuine validation checkpoints and no token waste. Its single real defect is navigation — the bundled reference writing-good-tests.md is never linked from the body, so a reader of SKILL.md alone would never discover it.
Suggestions
Link the existing reference from the body, e.g. under a "Writing good tests" note: "When writing the test itself, follow [writing-good-tests.md](references/writing-good-tests.md)" — the file currently sits in the bundle unreferenced.
Consider a one-line pointer for when deep guidance applies (mocks, expected values, cleanup helpers), mirroring the reference's own 'Load this reference when' header, so the trigger is discoverable from SKILL.md.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is 11 lines with no padding and no explanation of concepts Claude already knows (it never explains what TDD or testing is); every token earns its place, matching the "lean and efficient" anchor. | 5 / 5 |
Actionability | Each step is a concrete, executable directive with the key details specified — "Use a clear name and the real code, not mocks", "The test must fail because the behavior is missing, not because of a typo or a missing import", "Add nothing the test does not need". Per the scoring note, absence of code in an instruction-only skill is not penalized when guidance is this actionable. | 5 / 5 |
Workflow Clarity | The five steps are clearly sequenced with explicit validation checkpoints and feedback loops: verify the failure is for the right reason (step 2), confirm the test isn't vacuous ("If it passes, it tests nothing new: change the test"), and run the full suite after both green and refactor (steps 4-5). | 5 / 5 |
Progressive Disclosure | The body itself is well-organized, but the bundle contains references/writing-good-tests.md (~200 lines of test-writing guidance with mock/assertion rules) that the body never mentions — a reference that is present in the bundle but not signaled from SKILL.md, matching the anchor "references present but not clearly signaled". The under-50-line exception doesn't apply cleanly because an external reference exists and is orphaned. | 3 / 5 |
Total | 18 / 20 Passed |