Content
80%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 an exemplary lean, single-purpose instruction skill: concrete slop categories, an explicit reporting contract, and no wasted tokens. Its only real weakness is the absence of any validation step for what is a branch-wide batch of code edits, which the rubric caps at workflow clarity 3.
Suggestions
Add a verification step after the edits (e.g., run the project's tests or typecheck to confirm nothing broke) to lift workflow clarity above the destructive/batch cap of 3.
Include the concrete command for the first step, e.g., `git diff main...HEAD`, so the entry point is fully executable.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body ("Check the diff against main, and remove all AI generated slop introduced in this branch" plus a five-bullet list) is lean with zero padding and fully assumes Claude's competence; every token earns its place, matching the anchor-5 example's economy. | 5 / 5 |
Actionability | Concrete, actionable guidance throughout — specific slop categories ("Casts to any to get around type issues", "Extra defensive checks or try/catch blocks") and an explicit output contract ("only a 1-3 sentence summary") — but no exact command for checking the diff against main, leaving a minor gap versus fully executable guidance. | 4 / 5 |
Workflow Clarity | A rough sequence exists (check diff against main → remove slop → report summary), but this is a batch of code edits across a branch with no validation or verification step (e.g., run tests/lint, confirm behavior unchanged); the rubric explicitly caps workflow clarity at 3 for destructive/batch operations lacking validation. | 3 / 5 |
Progressive Disclosure | The skill is under 50 lines with no need for external references and is well organized (overview paragraph, categorized bullet list, closing reporting instruction), which the rubric says can score 5 for simple skills. | 5 / 5 |
Total | 17 / 20 Passed |