Content
85%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 exceptionally lean and self-consistent (written in the terse style it teaches) with concrete rules, patterns, and examples that make the single behavior unambiguous. Its main defect is the Tooling section: it advertises companion tools and a references file that do not exist in the bundle, breaking navigation and leaving tool usage unspecified.
Suggestions
Create the referenced references/companion_tooling.md (or remove the Tooling section) so the body's sole external reference resolves — the file is referenced twice but no references/ directory exists in the bundle.
If the compressor/estimator/lint tools ship with the skill, add a one-line invocation example for each in the Tooling section instead of bare names, so the tooling guidance is executable like the rest of the body.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is itself ultra-compressed ("Respond terse like smart caveman. All technical substance stay. Only fluff die.") and models the style it teaches; every section adds rules or examples Claude could not infer, with no padding or explanation of known concepts. Fits the 'lean and efficient; every token earns its place' anchor; not 4 because there are no instances of over-explanation to trim. | 5 / 5 |
Actionability | Concrete, executable guidance: enumerated drop lists ("articles (a/an/the), filler (just/really/basically/actually/simply), pleasantries (sure/certainly/of course)"), abbreviations, the "[thing] [action] [reason]" pattern, a Not/Yes contrast, and two Q&A examples. Not 5 because the Tooling section ("Tools: compressor + estimator + lint. Agent: cs-caveman-mode. Command: /cs:caveman.") names tools with no usage instructions and points to a file absent from the bundle — a minor gap. | 4 / 5 |
Workflow Clarity | A simple, single-purpose skill (under 50 lines) whose single action is unambiguous: apply the compression rules every response, with persistence rules ("ACTIVE EVERY RESPONSE once triggered... Off only when user says 'stop caveman'") and clearly sequenced exception handling ("Drop caveman temporarily for: security warnings, irreversible action confirmations... Resume caveman after clear part done") including a verification cue ("Verify backup exist first"). Per the simple-skill exception this scores 5; the destructive/batch validation cap does not apply since the skill performs no destructive operations itself. | 5 / 5 |
Progressive Disclosure | Sections are well organized (Persistence, Rules, Examples, Auto-Clarity Exception, Tooling), but the sole external reference "See [references/companion_tooling.md](references/companion_tooling.md)" is dangling — no references/, scripts/, or assets/ directories exist in the bundle, so the promised compressor/estimator/lint detail is inaccessible. Not 4 because a broken referenced path is more than a minor organization gap when scored against the actual bundle structure; not 2 because the core content is well-structured and nothing that belongs in a separate file is inlined. | 3 / 5 |
Total | 17 / 20 Passed |