Content
92%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 skill body: lean, opinionated, and sequenced with explicit done-when checkpoints and a verify-then-downgrade feedback loop, with detail correctly pushed to two real, one-level-deep reference files. The only weakness is minor executability gaps in the action guidance.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~30-line body contains no explanations of concepts Claude already knows and no padding; every line is instruction or a standard ("A finding with a failure scenario is a defect; without one it is a preference — drop it or mark it a nit"). This matches the lean, every-token-earns-its-place anchor. | 5 / 5 |
Actionability | Concrete, copy-paste commands are given for each platform ("git diff <base>...HEAD", "gh pr diff <id>", "ado pr diff <id> --hunks") and the output format is fully specified ("One finding per line: **what — where (`file:line`) — failure scenario — fix**"). Minor gaps keep it below anchor 5: how to determine the diff base is left implicit, the verify step's checks are conditional ("Run the relevant test or a read-only check when you can"), and no rendered example finding appears inline. | 4 / 5 |
Workflow Clarity | Five clearly sequenced steps each end in an explicit "*Done when*" checkpoint, and step 4 is a feedback loop ("try to prove it wrong... Keep what survives; set confidence from what you actually observed"). This matches the anchor requiring explicit validation steps and feedback loops; the destructive/batch cap does not apply since the skill is read-only by design. | 5 / 5 |
Progressive Disclosure | Both referenced files (references/lenses.md, references/findings.md) exist, are exactly one level deep, and are clearly signaled with their purpose ("see references/findings.md for the bar"). The bulky checklist content (lenses) is correctly split out of the overview, and the body itself is well organized — matching the clear-overview anchor. | 5 / 5 |
Total | 19 / 20 Passed |