Content
88%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, highly actionable reference card: concrete triggers, copy-paste configuration, and an unambiguous one-shot workflow. The only flaws are a duplicated manual/off configuration explanation and a config section that pushes the body past quick-reference length.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and table-driven with terse prose, but the manual/off configuration is explained twice ("For opt-in activation... set defaultMode to manual" and again "Set \"off\" to suppress... Use \"manual\" when bare /caveman should activate"), which is a minor trimmable redundancy keeping it at anchor 4 rather than anchor 5. | 4 / 5 |
Actionability | Guidance is fully executable: exact triggers per mode and skill, copy-paste-ready `export CAVEMAN_DEFAULT_MODE=ultracave` and JSON config snippets, an explicit resolution order ("env var > repo config > user config > caveman"), and legacy value handling — matching anchor 5. | 5 / 5 |
Workflow Clarity | As a simple single-purpose skill, its one action is unambiguous: "Display this reference card when invoked. One-shot — do NOT change mode, write flag files, or persist anything." There are no destructive or batch operations, so the simple-skill exception applies and the action plus explicit prohibitions merit a 5. | 5 / 5 |
Progressive Disclosure | Sections are well-organized (Modes, Skills, Deactivate, Language, Configure, More) with a clearly signaled one-level external link ("Full docs: https://github.com/JuliusBrussee/caveman") and no bundle files to reference. However, the body runs ~56 lines — just past the under-50 guideline — and the dense default-mode configuration could live in the external docs, fitting anchor 4 rather than 5. | 4 / 5 |
Total | 18 / 20 Passed |