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 router-style skill body: dense, policy-only content with concrete fully-qualified tool sequences, explicit availability/approval/error checkpoints, and a verified one-level-deep reference structure. It assumes Claude's competence and defers argument detail to authoritative live schemas by explicit design.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | "This file is a router. It carries only the global rules and the intent → tool → reference table" — every section is non-obvious policy (mutation boundaries, approval gating, error protocol) with zero padding and no explanation of concepts Claude already knows. Lean and efficient; every token earns its place. | 5 / 5 |
Actionability | The routing table gives fully qualified tool names with concrete sequences ("`mcp__cherry-tools__kb_list` → `kb_search` → `kb_read`", "`command -v` check → `cli_list` → `cli_search` → `cli_install`", "run JS/TS with `bun <file>`"), and the body explicitly justifies not restating argument shapes ("the live tool schema in your session is the authoritative source"). Covers the common routing cases concretely; not a 4, which would require gaps in the executable guidance. | 5 / 5 |
Workflow Clarity | Explicit checkpoints ("Check availability first", "resolve IDs first; needs approval") plus a feedback loop for errors ("read the message and correct the call; don't silently retry the same arguments", declined approval → "stop and report — never re-attempt the mutation through a different route") and a diagnostic section distinguishing absent tools from missing dependencies. Matches the explicit-validation-and-recovery anchor; mutation operations are gated, so the destructive-operation cap does not apply. | 5 / 5 |
Progressive Disclosure | A clear overview with a routing table pointing to exactly one reference per intent; all ten linked files (web.md, knowledge.md, documents.md, memory.md, autonomy.md, sessions.md, outputs.md, cli.md, skills.md, mcp.md) exist in references/ and cross-link only laterally — one level deep, well-signaled, easy navigation. Matches the clear-overview-with-one-level-references anchor. | 5 / 5 |
Total | 20 / 20 Passed |