Content
100%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.
The body is exemplary for a process skill: a terse statement of the loop, four enforceable rules, a done-checklist, and a single well-scoped reference file for test-writing detail. It adds only what Claude would not already know and structures everything for immediate use.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is ~19 lean lines that assume Claude already knows what TDD is and adds only project-specific rules ("No production code without a failing test first", "Code written before its test is deleted and written again from the test"). Every token earns its place — no concept explanations, no padding — matching the score-5 anchor exactly. | 5 / 5 |
Actionability | For an instruction-only process skill, the guidance is fully directive: the four imperative steps of the cycle, concrete rules covering the common cases (new feature, bug fix via "a test that reproduces the bug", hard-to-write test → "simplify the interface"), and an explicit done-checklist. Per the rubric's scoring note, absence of code is not penalized when the guidance is actionable, and nothing here is vague. | 5 / 5 |
Workflow Clarity | The multi-step cycle is sequenced explicitly ("Write the test first. Watch it fail. Write the minimal code to pass. Refactor with the tests green.") with built-in validation checkpoints — watching the test fail is the checkpoint, and "Before you say it is done" requires that "Each new behavior has a test that you saw fail first" and "The full suite passes on the final code". This matches the score-5 anchor (explicit validation steps plus a checklist); the workflow is not destructive or batch, so no cap applies. | 5 / 5 |
Progressive Disclosure | The body is well under 50 lines with test-quality detail correctly split into references/writing-good-tests.md (verified to exist, 8KB), referenced exactly once, one level deep, with a clear load condition ("When writing or changing a test, read…") that the reference file itself echoes ("Load this reference when: writing or changing tests…"). This matches the score-5 anchor for well-signaled one-level-deep references in a compact skill. | 5 / 5 |
Total | 20 / 20 Passed |