Content
100%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 dense, executable, and well-structured: concrete commands throughout, an explicit dry-run-first workflow with validation checkpoints, and clean one-level-deep references to a complete bundle. It avoids teaching concepts Claude already knows.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Lean and token-efficient: no padding explaining what ASTs or libraries are, dense tables, and a decision tree that earns every token; assumes Claude's competence throughout. | 5 / 5 |
Actionability | Copy-paste-ready commands for every helper subcommand and direct `sg` idiom, covering search, replace (dry-run and apply), scan, validate, and debug flows with concrete flags. | 5 / 5 |
Workflow Clarity | Multi-step rewrite workflow is explicitly sequenced (search → dry-run → inspect → refine-or-apply) with a feedback loop, plus a prioritized 0-matches debugging triage and validation invariants for destructive/batch operations. | 5 / 5 |
Progressive Disclosure | Clear overview in SKILL.md pointing one level deep to 7 real reference files and a helper script, with a prioritized 'Required reading' list and explicit per-file triggers; all referenced paths exist. | 5 / 5 |
Total | 20 / 20 Passed |