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 exceptionally disciplined skill body: lean, well-sequenced, with strong conditional progressive disclosure and validation checkpoints throughout. The main improvement opportunity is grounding the more abstract guidance (discovery instruments, proof records) with a worked example or concrete commands.
Suggestions
Add one worked proof-record example (a filled-in Candidate/Burden/Reachability/... entry for a typical dead-code candidate) so the template's expected granularity is unambiguous.
Give a concrete example of using repository-native discovery instruments (e.g., a representative search, compiler dead-code warning, or dependency-metadata query) rather than naming the instrument classes only.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and dense with no padded explanations of concepts Claude already knows; every sentence carries operational weight ('Line-count reduction is supporting evidence, not the objective'), matching anchor 5. | 5 / 5 |
Actionability | The instruction-only guidance is mostly concrete — a copy-paste proof-record template, enumerated keep/downgrade conditions, and mode/scope selection rules — but discovery instruments are described abstractly ('Use repository-native search, compiler and linter output') with no worked example of a completed proof record, leaving minor gaps. | 4 / 5 |
Workflow Clarity | A clear sequence (select mode/scope → establish contract → cover surface → build proof record → decide → deliver) with explicit validation checkpoints appropriate to a potentially destructive skill: baseline capture ('capture a proportional baseline'), 'the smallest check that would expose an incorrect cut', and the required validation and operation receipt. | 5 / 5 |
Progressive Disclosure | The body serves as a clear overview with five conditionally-signaled, one-level-deep references ('For every Broad engagement... read investigation.md'; 'In Change mode, read execution-and-recovery.md'), all of which exist as real files in references/, with detail appropriately split out of SKILL.md. | 5 / 5 |
Total | 19 / 20 Passed |