Content
96%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 well-structured instruction skill: concise, actionable, and rich with validation checkpoints and a hard destructive-action gate. The only gap is progressive disclosure — it leans monolithic with no reference files splitting out the longer prose.
Suggestions
Move the Gotchas and Loop mode sections into a separate references/ file (e.g. references/GOTCHAS.md) and link to it one level deep, keeping SKILL.md as a lean overview.
Verify the skills/FRAMEWORKS.md reference resolves to a real bundle file, or replace it with an in-skill pointer that does not depend on an external path.
Consider extracting the Step 6 held-action rules into a short reference checklist so the blast-radius gate is reusable and the main flow stays scannable.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and instruction-oriented ("Hunt repetition, not complaints"; "A half-built automation costs more than none") with no padding explaining concepts Claude already knows; every line earns its place. | 5 / 5 |
Actionability | Though instruction-only, the guidance is concrete and executable throughout — "frequency-rank the shell history", "Run 5 Whys... three tiers minimum", "Rank by leverage times frequency", "fail loud (nonzero exit)", "hand back each held action as an exact command". | 5 / 5 |
Workflow Clarity | Eight sequenced steps each end in an explicit "Done when..." checkpoint, Step 7 supplies verification (run twice, prove dedup, chase a surprising output to ground truth), and Step 6 is a hard validation gate for destructive actions — satisfying the destructive-operations cap. | 5 / 5 |
Progressive Disclosure | Sections are well-organized with a See Also pointing to sibling skills and skills/FRAMEWORKS.md, but no bundle files exist and the ~140-line body inlines Gotchas and loop-mode prose that could live in one-level-deep reference files, leaving it slightly monolithic. | 4 / 5 |
Total | 19 / 20 Passed |