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.
An exemplary minimal body for a hook-delivered skill: it documents exactly the non-obvious delivery mechanism and the model's (non-)role with zero waste. The only improvement would be one sentence of fallback guidance for when the hook is absent or fails.
Suggestions
Add a brief fallback instruction, e.g., "If the hook is not installed or fails, tell the user this skill requires the caveman-mode hooks rather than attempting to compute stats yourself" — this would close the actionability gap.
Optionally state where the user sees the output and roughly what the injected stats look like, so the model can answer follow-up questions about the numbers without guessing.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is four lean sentences covering only what Claude would not already know — the hook delivery path (`hooks/caveman-stats.js`, `hooks/caveman-mode-tracker.js`) and the `decision: "block"` mechanism. There is no padding, no explanation of known concepts, and every token earns its place, matching anchor 5. | 5 / 5 |
Actionability | The guidance is concrete and executable for the intended path — "The model does not need to do anything when this skill fires — the hook returns `decision: \"block\"` with the formatted stats as the reason" — with real file names and hook semantics. It falls short of anchor 5 only because there is no fallback instruction (e.g., what to do if the hook is not installed or fails), leaving a minor gap. | 4 / 5 |
Workflow Clarity | This is a simple, single-purpose skill where the entire workflow is one unambiguous action: the model does nothing and the hook handles everything. Per the simple-skill exception, the unambiguous single action merits 5, and no destructive or batch operations exist that would trigger the validation cap. | 5 / 5 |
Progressive Disclosure | The body is under 50 lines with no content that warrants external reference files; the inline pointers to `hooks/caveman-stats.js` and `hooks/caveman-mode-tracker.js` are one level deep and clearly signaled, and no references/ or scripts/ bundle exists. Per the under-50-lines guideline this matches anchor 5. | 5 / 5 |
Total | 19 / 20 Passed |