Content
100%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 instruction-only skill body: it orchestrates a CLI through concrete, copy-paste-ready commands with a state-driven workflow, embeds explicit validation checkpoints and error-recovery guidance for paid and destructive operations, and pushes all detail to seven real, one-level-deep reference files. It teaches only what Claude could not already know.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense prescriptive guidance with no concept explanations — lines like "A finished run exits 0 even when scenarios fail; `ok: true` can also describe a refused run" deliver non-obvious operational rules, and version drift is handled generically ("Use this workflow across compatible releases") without dated pins. Nothing is padded or over-explained, so it matches the lean anchor rather than the 4 anchor's 'minor instances that could be trimmed'. | 5 / 5 |
Actionability | Commands are concrete and copy-paste ready throughout: `rook doctor`, `rook status --json`, `rook plan --json`, a need-to-command table with exact flags (`rook sync --yes` before `rook run --json`, `rook profile test --goal "<reply-only goal>"`, `LT_USERNAME`/`LT_ACCESS_KEY` for CI). Placeholders like `<id>` are inherent, not gaps, so it fits the fully-executable anchor. | 5 / 5 |
Workflow Clarity | The lifecycle is sequenced via the state-driven table (sign in → project → explore → agent → generate → profile → run → report) with explicit validation checkpoints ("Check the exit status and `discarded`/`halted` fields before claiming completion"; inspect `agent.yaml` for `calls[]` entries with `write: true` before reaching commands) and error-recovery loops ("If a command or output differs, consult its help and release notes before adapting that step"). Validation for the destructive/paid operations is present, so the workflow-clarity cap of 3 does not apply and it matches the explicit-checkpoints anchor. | 5 / 5 |
Progressive Disclosure | The ~100-line overview splits content appropriately: all seven referenced files (profiles.md, scenarios.md, troubleshooting.md, headless-contract.md, verdicts.md, ci.md, mcp.md) exist in references/, are linked inline where contextually needed or in an annotated References section, and contain no nested references (one level deep). This matches the clear-overview anchor; not 4 because navigation and placement have no organization gaps. | 5 / 5 |
Total | 20 / 20 Passed |