Content
82%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 lean, highly actionable skill with copy-paste commands, an unambiguous mode-selection flow, and concrete interpretation and reporting requirements. The main gaps are minor: trimming definitions of mutation-testing basics Claude already knows, and lacking a recovery path for a failed or interrupted mutants run.
Suggestions
Trim the parenthetical explanations of Caught/Missed ('good; test suite detected the bug') — Claude knows mutation-testing semantics; keep only the tool-output mapping.
Add a short fallback for a failed or interrupted cargo-mutants run (e.g. what to do with partial output or mutants.out.old before it is deleted), which would close the last workflow-clarity gap.
Consider splitting the missed-mutant example pattern and output-format spec into a small reference file if the skill grows, keeping SKILL.md as the overview.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is efficient and operational throughout — no padding, no conceptual lecture, and sections like the missed-mutant example pattern earn their tokens. It falls just short of anchor 5 because of minor over-explanation Claude doesn't need, e.g. the parentheticals defining Caught/Missed ('good; test suite detected the bug', 'a plausible bug went undetected') restate mutation-testing semantics. Not anchor 3: there is no genuinely unnecessary section or flabby explanation. | 4 / 5 |
Actionability | Guidance is fully executable and copy-paste ready: `cargo mutants --version` with an exact install fallback (`cargo install cargo-mutants --locked`), complete commands with flags for both diff and full modes, an explicit empty-diff stop condition, a worked example of how to explain a missed mutant, and a concrete score formula (`<caught> / <total>`). This matches anchor 5 ('fully executable; copy-paste ready commands; specific examples cover the common cases'). | 5 / 5 |
Workflow Clarity | The sequence is clear (verify install → choose mode → run → interpret → report) with several real checkpoints: install fallback on failure, empty-diff detection with an explicit stop, waiting for the user's mode choice, and warning about the 15–60 min runtime. It is not anchor 5 because there is no error-recovery loop for the run itself — no guidance for a failed or partially completed cargo-mutants run (e.g. resuming from mutants.out.old, which the command deletes). Anchor 3 would require missing or merely implicit checkpoints, which is not the case. | 4 / 5 |
Progressive Disclosure | No bundle files exist, and the body is well-organized into clearly labeled sections (Choose a mode, Run, Interpret, Output format) that all belong inline at this size. This is good structure with content appropriately placed (anchor 4). It is not anchor 5: at ~68 lines it exceeds the under-50-line simple-skill case where well-organized sections alone earn a 5, and there is no reference signaling to evaluate — the output-format section is the only borderline candidate to split out. | 4 / 5 |
Total | 17 / 20 Passed |