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 strong skill body: a numbered TDD workflow with genuine validation checkpoints and user-review stop points, executable RSpec commands, a concrete spec-plan template, a decision table for what gets its own spec, and clean one-level-deep reference files. The only weakness is mild over-explanation of general testing concepts in the Philosophy section that could be trimmed for token efficiency.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense, imperative, and mostly free of padding — commands, a full example spec plan, and short rule statements. A few philosophy passages explain concepts Claude already knows ("Tests serve two purposes...", the Given/When/Then shape, DAMP over DRY, tautological tests), which could be trimmed; most of the philosophy instead encodes this workflow's specific doctrine (seam selection, vertical slices, stop points), so it sits at 4 rather than 3, and well above 3 rather than 5 only because of those trimmable passages. | 4 / 5 |
Actionability | Fully executable throughout: concrete `bundle exec rspec` invocations for single files, line numbers (`spec/models/game_spec.rb:24`), description matching (`-e 'for_player'`), and the full suite; a copy-paste-ready spec-plan template under `docs/plans/<feature>-spec-plan.md`; and per-step instructions like "confirm it fails for the right reason (missing route, missing method, missing template), not a syntax error." Specific examples cover the common cases (system, model, request specs). | 5 / 5 |
Workflow Clarity | The 5-step process is clearly sequenced with explicit validation checkpoints and feedback loops: confirm the test fails for the right reason before implementing, re-read the spec file after user edits, loop read-failure → implement → re-run until green, tick plan checkboxes, then a completeness check against the feature summary and a regression check over Related specs. The Prove-It bug pattern adds its own validate (failing repro) → fix → full-suite loop. This matches the 5 anchor's 'explicit validation steps; feedback loops for error recovery' and is clearly not the 4 anchor, whose validation is only implied ('Verify output is valid') — here validation is an explicit numbered step with a failure branch. | 5 / 5 |
Progressive Disclosure | The SKILL.md is a well-organized overview (philosophy, process, decision table, commands) and pushes spec examples into three clearly signaled, one-level-deep references that all exist in the bundle: `references/system_spec.rb`, `references/model_spec.rb`, and `references/spec_conventions.md`, each introduced by a named section with an instruction to "Read the appropriate reference before writing a new spec." No nested references, no buried pointers, and inline content is limited to key conventions rather than full spec listings. | 5 / 5 |
Total | 19 / 20 Passed |