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 lean skill body: fully executable commands, a well-sequenced workflow with validation branches for the failure modes that actually occur, and tight constraints (one pass, no code edits, no re-runs) that prevent scope drift. No bundle files exist, and none are needed at this size.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Every line carries non-obvious, skill-specific information ("A non-zero exit is expected when mutants survive — do not treat it as failure", the `<!-- mutation-review -->` marker, the 5-comment cap) with zero padding or explanation of concepts Claude already knows. | 5 / 5 |
Actionability | The guidance is copy-paste ready: `npm run mutate:diff`, the `reports/mutation/mutation.json` path, `gh pr comment "$PR" --body-file <file>`, the complete `gh api repos/$REPO/pulls/$PR/comments` invocation with all fields, and `git diff --merge-base origin/main` for the changed-line check. | 5 / 5 |
Workflow Clarity | The six steps are clearly sequenced with explicit checkpoints and recovery branches: expected non-zero exit, missing-report file → stop, all-mutants-killed → alternate comment, and a git-diff verification gate before posting inline comments, plus a 5-comment cap on the batch posting. | 5 / 5 |
Progressive Disclosure | The body is under 50 lines, self-contained with no need for external references, and organized into clear Inputs and Workflow sections — meeting the rubric's simple-skill standard for full marks. | 5 / 5 |
Total | 20 / 20 Passed |