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 skill body: a tight red-green-refactor workflow with built-in validation checkpoints, a failure-diagnosis feedback loop, hard rules, and a done checklist, with test-writing detail properly pushed to a single, well-signaled, one-level-deep reference. The only minor gap is the absence of any inline example (e.g., a sample test name or how to find the project's test command).
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The 26-line body is lean and every sentence instructs rather than explains: 'Write one test for one behavior. Use a clear name and the real code, not mocks' and 'If it passes, it tests nothing new: change the test'. It assumes Claude's competence (no explanation of what TDD is, what tests are, or why they matter), matching the anchor 'every token earns its place'; no trimming is possible without losing guidance. | 5 / 5 |
Actionability | The guidance is concrete and executable for an instruction-only skill: each cycle step names the action and its guard ('The test must fail because the behavior is missing, not because of a typo or a missing import'), and rules like 'A bug fix starts with a test that reproduces the bug' are directly followable. It stops short of level 5 because there are no inline examples or commands — e.g., no sample test name or a way to discover the project's test command — leaving minor gaps even though detail is properly delegated to references/writing-good-tests.md. | 4 / 5 |
Workflow Clarity | The five-step cycle is clearly sequenced with explicit validation checkpoints ('Watch it fail', 'Watch it pass. Run the full suite'), a feedback loop for error recovery ('If it passes, it tests nothing new: change the test'), and a completion checklist ('Before you say it is done'). This matches the level-5 anchor — explicit validation steps, feedback loops, and a checklist; this is not a destructive/batch operation so no cap applies. | 5 / 5 |
Progressive Disclosure | The body is a clear overview of the process, and the single detail file is well-signaled at the exact point of need ('When writing or changing a test, read references/writing-good-tests.md'). The referenced file exists and is one level deep — it contains no further references or links — so navigation is trivial. This matches both the under-50-lines exception (well-organized sections suffice) and the clear-overview-with-one-level-references anchor. | 5 / 5 |
Total | 19 / 20 Passed |