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, fully actionable skill body whose form matches its content — every token earns its place and the guidance is copy-paste concrete. The one notable gap is that two of the three reference files are orphaned from SKILL.md, including when_caveman_backfires.md which would naturally be pointed to from the Auto-Clarity Exception section.
Suggestions
In the Auto-Clarity Exception section, link when_caveman_backfires.md (e.g., 'Failure modes: see [references/when_caveman_backfires.md]') so the backfire guidance is reachable from the entry point.
Mention compression_principles.md alongside companion_tooling.md in the Tooling section, since it is the reference paired with the compressor script.
Drop the trailing 'Version/Derived' footer from the body — it duplicates frontmatter metadata and costs tokens.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body practices its own compression: specific banned-word lists ('just/really/basically/actually/simply'), a terse pattern template, and no explanation of concepts Claude already knows. Every section earns its place; the only overhead is the trailing version footer duplicating frontmatter. | 5 / 5 |
Actionability | Fully executable guidance for an instruction-only skill: explicit drop lists, abbreviation vocabulary ('DB/auth/config/req/res/fn/impl'), a response pattern ('[thing] [action] [reason]. [next step].'), a Not/Yes contrast pair, and two worked Q&A examples. Claude knows exactly what to do after reading it. | 5 / 5 |
Workflow Clarity | A simple single-purpose skill where the single action is unambiguous: activation ('ACTIVE EVERY RESPONSE once triggered'), exit conditions ('stop caveman' or 'normal mode'), and a scoped Auto-Clarity Exception with a clear drop/resume sequence and a concrete destructive-op example. The destructive-batch validation cap does not apply to a communication-style skill. | 5 / 5 |
Progressive Disclosure | The body is a lean overview that clearly signals references/companion_tooling.md (verified to exist, one level deep). However, the other two bundle references — compression_principles.md and when_caveman_backfires.md — are never referenced from SKILL.md, making a third of the reference material discoverable only by directory listing. Good structure with a real, if bounded, navigation gap. | 4 / 5 |
Total | 19 / 20 Passed |