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 instruction-only skill body: a terse, sequenced TDD cycle with built-in validation checkpoints, an explicit feedback loop, a completion checklist, and exactly one well-signaled reference that exists and goes only one level deep. The only minor gap is the absence of any concrete example command or test snippet, which keeps actionability at 4 rather than 5.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and imperative ("Write the test first. Watch it fail. Write the minimal code to pass. Refactor with the tests green.") with zero padding and no re-explanation of TDD concepts Claude already knows. Every token earns its place, matching the level-5 anchor exactly. | 5 / 5 |
Actionability | The guidance is concrete and executable — "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 validation criteria for each step. It falls short of level 5 only because no example command or concrete test snippet is shown (justifiably project-dependent, but still a minor gap), matching the level-4 anchor; per the scoring notes, absence of code in an instruction-only skill is not penalized when guidance is actionable. | 4 / 5 |
Workflow Clarity | The five-step cycle is clearly sequenced with explicit validation checkpoints ("Watch it fail" with failure-mode diagnosis, "Watch it pass. Run the full suite. Every test passes, with no errors or warnings", "Run the suite again" after refactor), an error-recovery feedback loop (test passes early → change the test), and a done-checklist ("Before you say it is done"). This matches the level-5 anchor: clear sequence, explicit validation, feedback loops, and a checklist. | 5 / 5 |
Progressive Disclosure | The body is under 50 lines, well-organized into sections (The cycle, Rules, Before you say it is done), and includes one clearly-signaled, one-level-deep reference — "read [references/writing-good-tests.md](references/writing-good-tests.md)" — which exists as a real file containing no nested references. Per the judging guidelines, a short skill with no need for external references scores 5 with just well-organized sections, and the single well-signaled reference reinforces this. | 5 / 5 |
Total | 19 / 20 Passed |