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.
An exemplary router skill: lean, fully actionable, with clear sequencing and explicit routing tie-breakers, delegating all implementation detail to one of two well-signaled playbooks. The only structural weakness is the orphaned references/api-reference.md, which no file in the skill's navigation points to.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~35-line router body contains zero concept explanation and no padding; every line is a routing rule or handoff constraint (e.g. "A detailed acceptance contract does not turn a greenfield build into an iteration"). It fully assumes Claude's competence and every token earns its place. | 5 / 5 |
Actionability | Guidance is fully executable for an instruction-only router: exact file paths (references/planner.md, references/iterate.md), a numbered handoff sequence, and explicit prohibitions ("Do not read project files, call Bash, create a plan, or invoke a specialist between this router and the selected playbook"). The absence of code is appropriate per the instruction-only scoring note. | 5 / 5 |
Workflow Clarity | The routing decision has explicit disambiguation checkpoints ("Observable workspace state wins over wording" plus four tie-breaker bullets), and the handoff is a clear 4-step sequence including stating the route aloud before loading. No destructive or batch operations exist, so no validation cap applies; the single routing action is unambiguous. | 5 / 5 |
Progressive Disclosure | The body is an ideal thin overview pointing to exactly two real, clearly signaled playbook files (both verified to exist) that are loaded one at a time. However, bundle inspection shows references/api-reference.md (1532 lines) is referenced nowhere in SKILL.md or the playbooks, leaving a large file undiscoverable through navigation — a minor organization gap that keeps this below the 5 anchor. | 4 / 5 |
Total | 19 / 20 Passed |