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.
Exemplary instruction-only skill content: dense with concrete, copy-paste-ready commands and exact behavioral rules, clear multi-step workflows with confirmation checkpoints and error-recovery loops, and near-zero padding. The only structural refinement left is that some domain-detail sections (Sub-agents, Models) could move to reference files to shorten the always-loaded body.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and directive throughout — "Raven's source code, logs and config files are not a manual", "do not answer from what you believe about yourself" — with no explanation of concepts Claude already knows and every line carrying Raven-specific rules; each token earns its place. | 5 / 5 |
Actionability | Fully executable guidance: exact tool syntax (`describe subagents.<name>`, `add subagents {"preset": "codex"}`, `set` with JSON value examples like `{"provider": "openrouter", "model": "anthropic/claude-sonnet-5"}`, `restart` with "reload"), and even a copy-paste CLI (`raven ops connection add --auth password --password-stdin --non-interactive`) covering the common cases. | 5 / 5 |
Workflow Clarity | Multi-step flows are explicitly sequenced with validation checkpoints and feedback loops: diagnosis-before-change ("a diagnosis is not permission"), collect-all-changes → ask once → restart, and the sub-agent failure loop with a bail-out ("if three have not told you why, stop and report what you saw"), plus verification via the `set` reply's old/new values. | 5 / 5 |
Progressive Disclosure | A single file with clear, well-ordered sections (find → change → takes effect → per-domain detail) and no nested references, but at ~215 lines the detailed per-domain sections (Sub-agents, Models) could arguably be split into one-level-deep reference files; good structure with minor organization gaps. | 4 / 5 |
Total | 19 / 20 Passed |