Content
92%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.
A tight, well-organized reference card: every token is non-derivable fact, the single action is unambiguous with explicit negative constraints, and the section structure is clean for a small single-file skill. The only minor gap is that the exact output format of the displayed card is left implicit.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and table-driven ('Drop filler. Keep sentence structure.'), with zero space given to concepts Claude already knows; every line carries non-derivable facts such as the mode list, triggers, and the config resolution order 'env var > config file > full'. Matches the anchor for lean and efficient content where every token earns its place. | 5 / 5 |
Actionability | Concrete user commands ('/caveman lite', '/caveman-commit'), copy-paste config snippets ('export CAVEMAN_DEFAULT_MODE=ultra' and the JSON config example), and exact deactivation phrases ('stop caveman', 'normal mode') make the guidance mostly executable. It is not 5 because 'Display this reference card... Output in caveman style' leaves the exact output form (verbatim tables vs. reformatted card) implicit. | 4 / 5 |
Workflow Clarity | This is a simple single-task skill, so the simple-skill exception applies: the single action is unambiguous — 'Display this reference card when invoked. One-shot — do NOT change mode, write flag files, or persist anything.' The explicit negative constraints remove ambiguity, and there are no destructive or batch operations, so the validation cap does not apply. | 5 / 5 |
Progressive Disclosure | The bundle contains no references/, scripts/, or assets/ directories — this is a small single-file skill, and the under-50-lines exception applies: the content is organized into clear sections (Modes, Skills, Deactivate, Configure Default Mode, More) with a clearly signaled external docs link (https://github.com/JuliusBrussee/caveman). | 5 / 5 |
Total | 19 / 20 Passed |