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 exemplary terse skill body: dense, actionable, and well-structured. The only real defect is a broken reference — the body points to references/companion_tooling.md, but no references/ directory or file ships with the skill.
Suggestions
Ship the referenced references/companion_tooling.md (or remove the link) so the one external reference resolves; a broken link is the sole thing holding progressive_disclosure below 5.
Clarify in the Tooling section whether cs-caveman-mode / /cs:caveman are bundled commands or external prerequisites, so the guidance is self-contained even if the reference is missing.
Add a one-line 'How to stop' trigger alongside the existing 'stop caveman'/'normal mode' phrasing in the body's Persistence section to mirror the description's explicit off-switch.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Lean and efficient to the point of dogfooding its own brevity mandate — no explaining of concepts Claude already knows; every line (rules, pattern, before/after examples) earns its place. | 5 / 5 |
Actionability | Concrete, copy-paste-style guidance: explicit Drop/Keep lists (articles, filler, abbreviations like DB/auth/config), a precise output pattern '[thing] [action] [reason]. [next step].', and worked before/after examples covering common cases. | 5 / 5 |
Workflow Clarity | A simple single-purpose style skill with an unambiguous action; sections sequence trigger→rules→examples→exception→resume, and the Auto-Clarity Exception even models a validation checkpoint ('Verify backup exist first') for the illustrative destructive case, satisfying the simple-skill exception. | 5 / 5 |
Progressive Disclosure | Well-organized sections under 50 lines with a one-level-deep, clearly signaled pointer to references/companion_tooling.md; held at 4 rather than 5 because that referenced file does not exist in the bundle, making the navigation link broken. | 4 / 5 |
Total | 19 / 20 Passed |