Content
85%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The body is a well-structured operating-mode skill with clear sequenced workflows, explicit verification gates for destructive deletions, and properly signaled one-level-deep references. Its main weakness is length and conceptual overlap across the vision, finding-format, and final-check sections.
Suggestions
Consolidate the overlapping 'Greenfield Vision First', 'Finding Format', and 'Final Check' sections, which restate the same fields (uncompromised vision, product sentence, backward path, deletion prize); keep one canonical template and have the others reference it.
Tighten the 'Smell Catalog' and 'Asymmetric Wins Pass' refusal lists, which overlap heavily (dual readers/writers, compatibility aliases appear in both); merge or cross-link to remove redundant tokens.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and operational with no padding of concepts Claude already knows, but it is long (~345 lines) and overlaps recur — the 'Greenfield Vision First' model, the 'Finding Format', and the 'Final Check' restate similar fields, so it could be tightened. | 2 / 3 |
Actionability | As an instruction/operating-mode skill it gives concrete procedural guidance: a 7-step context-gathering list ('Count callers and imports with rg'), a 10-step execution loop, a named smell catalog, and explicit stop-and-ask triggers. | 3 / 3 |
Workflow Clarity | Multi-step processes are clearly sequenced with validation checkpoints for a destructive workflow — 'Prove the new path before deleting the old one', 'Verify with targeted tests, typecheck, and relevant smoke coverage', and 'Re-run rg for stale names' — plus a Stop And Ask gate. | 3 / 3 |
Progressive Disclosure | The References section signals two on-demand files with conditional load triggers ('If planning a multi-wave replacement... read references/wave-ordering.md'), both of which exist on disk, kept one level deep with the body as an overview. | 3 / 3 |
Total | 11 / 12 Passed |