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 a model instruction-only skill: lean, fully executable, with explicit STOP/validation checkpoints and error-recovery loops at every stage of the red-green cycle. It delegates project conventions to existing files rather than restating them, keeping every token load-bearing.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Every line is an executable instruction ("run `npm test`", "Write the Gherkin scenario in `tests/features/<name>.feature`") with zero concept explanations or padding; the step-7 sub-bullets ("Stateful behaviour inside `boot()` as closures", "Route dataset data through `StateManager`") convey repo-specific knowledge Claude cannot infer. This matches 'lean and efficient; every token earns its place'. | 5 / 5 |
Actionability | The body provides concrete commands (`npm test`, `npm run check`), exact file paths (`tests/features/<name>.feature`, `tests/e2e/<name>.spec.js`, `src/app.js`), and a concrete import location (`tests/support/helpers.js`). As an instruction-only skill with fully executable, copy-paste-ready guidance, it matches the top anchor; per the scoring notes, absence of code is not penalized here. | 5 / 5 |
Workflow Clarity | The 10-step sequence includes explicit validation checkpoints and feedback loops: step 2 ("If it fails, stop and report"), step 4 ("**STOP** — ... wait for explicit approval"), step 6 ("If it passes already, the test is wrong — stop and report"), and step 9's fix-violations loop. This matches 'clear sequence with explicit validation steps; feedback loops for error recovery'. No cap applies since the operations are additive, not destructive or batch. | 5 / 5 |
Progressive Disclosure | The skill is under 50 lines, single-purpose, with no bundle files; it is one well-ordered numbered list and delegates repo conventions to existing project files (CLAUDE.md, tests/CLAUDE.md, src/CLAUDE.md) instead of duplicating them. Per the guideline for skills under 50 lines with no need for external references, well-organized content scores 5. | 5 / 5 |
Total | 20 / 20 Passed |