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.
An exemplary instruction-only SKILL.md body: concise, immediately actionable with concrete templates and commands, and a well-sequenced workflow that includes an explicit suspect-confirmation feedback loop and dedup checkpoint. Safety constraints are separated into their own section without bloating the guidance.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~45-line body is lean with no padding and no explanation of concepts Claude already knows; every line is directive ("Read every `*.test.ts` file under `src/`", "Check the open issues first"). The single framing sentence ("A test that can't fail is worse than no test") earns its place by defining the skill's purpose, matching the score-5 anchor. | 5 / 5 |
Actionability | Guidance is fully executable for an instruction-only skill: specific defect patterns ("comparing a value with itself", "`it.skip`, `describe.skip`, `it.todo`"), a concrete issue title template ("`Tests: <test name> can't catch a broken <behaviour>`"), a required body contents list, a real verification command ("`npm run check` passes"), and a concrete confirmation procedure (try a small breaking change, check the test still passes, undo it). No pseudocode or vague direction remains. | 5 / 5 |
Workflow Clarity | The sequence is clear and includes explicit validation checkpoints despite being a batch operation: read every test, classify against four named patterns, confirm suspects via a break-and-revert feedback loop, dedupe against open issues ("Check the open issues first"), then file per the template, with "Nothing found is a fine result" covering the empty case. The mutation-based confirmation is exactly the feedback loop the score-5 anchor rewards, so the batch-operation cap does not apply. | 5 / 5 |
Progressive Disclosure | The skill is under 50 lines with no external material needed (no references/, scripts/, or assets/ exist in the bundle), and it is organized into four well-labeled sections (Staying safe, What to look for, What to file). Per the rubric's simple-skill guideline, this earns a 5 with well-organized sections alone. | 5 / 5 |
Total | 20 / 20 Passed |