Content
86%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.md: lean, concrete, and honestly structured as an overview that delegates each domain's details to one-level-deep references that all exist. Only minor rule duplication and validation deferred to the references keep conciseness and workflow clarity just below top marks.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is a lean router with no padding and no explanation of concepts Claude already knows ("This guide never restates argument shapes — the live tool schema in your session is the authoritative source"). Minor trimmable redundancy keeps it below the top anchor: the declined-approval rule is stated twice nearly verbatim ("if approval is declined, stop and report — do not retry the same effect through another route" vs "On declined approval, stop and report — never re-attempt the mutation through a different route"), and the mutation-boundary rule appears in both the intro and Global rules. | 4 / 5 |
Actionability | Fully concrete guidance: exact fully-qualified tool names, per-intent sequences in the routing table (e.g. "kb_list → kb_search → kb_read", "command -v check → cli_list → cli_search → cli_install (approval)"), explicit approval gating per tool, and a linked reference file for every row. For an instruction/routing skill this is copy-paste-ready equivalent — the common cases are all covered. | 5 / 5 |
Workflow Clarity | Clear routing-level sequence with real checkpoints ("Check availability first", "resolve IDs first; needs approval") and explicit error-recovery feedback loops ("read the message and correct the call; don't silently retry the same arguments"). Falls just short of the top anchor because per-operation output validation and deep per-domain sequencing are deferred to the references rather than present in the body. | 4 / 5 |
Progressive Disclosure | A true overview router: it carries only global rules and the intent → tool → reference table, and every one of the 11 referenced files (web.md, automation.md, knowledge.md, documents.md, memory.md, autonomy.md, sessions.md, outputs.md, cli.md, skills.md, mcp.md) exists and is clearly signaled per intent row. References cross-link only to siblings (e.g. web.md → automation.md), staying one level deep with no nesting. | 5 / 5 |
Total | 18 / 20 Passed |