Content
88%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 body: token-efficient, assumption of competence, a fully concrete routing table with a tie-breaker rule and a citation-verification checkpoint. The only flaws are cosmetic — inconsistent path prefixes between the routing table and the instruction/quick-start lines.
Suggestions
Unify path prefixes: the routing table's Path column ('skills/<skill>/') should match the instruction line and quick start ('ra-qm-team/skills/<skill>/') so the load target is unambiguous.
State what to do when no row matches (e.g., 'if no row matches, say so and ask for more detail') to close the routing decision tree.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~40-line body is lean and functional: a dense signal→skill→path routing table, a two-line quick start, and three terse rules. It assumes Claude's competence — no padding explaining what the standards are or how compliance works — so every token earns its place, matching anchor 5. | 5 / 5 |
Actionability | Concrete, executable guidance throughout: an exact routing table with paths, a copy-pasteable quick-start command ('cat ra-qm-team/skills/risk-management-specialist/SKILL.md'), and a tie-breaker rule for multi-match cases. The minor gap is a path-prefix inconsistency — the table's Path column says 'skills/...' while the instruction line and quick start use 'ra-qm-team/skills/...' — so anchor 4 rather than fully unambiguous anchor 5. | 4 / 5 |
Workflow Clarity | This is a simple single-purpose skill (route to exactly one skill) and the single action is unambiguous: match request signals in the table, load the named SKILL.md, ask one clarifying question on multi-match, and a citation-verification checkpoint ('Verify regulatory citations against the current text'). Per the simple-skill exception, this warrants 5; no destructive or batch operations apply a cap. | 5 / 5 |
Progressive Disclosure | The router correctly delegates all detail to the 15 sibling skills — one level deep, clearly signaled via the routing table — with well-organized sections (Routing table / Quick start / Rules). However, the referenced paths are given with inconsistent prefixes ('skills/...' vs 'ra-qm-team/skills/...') and no bundle is present to verify them, which is a minor organization gap matching anchor 4 rather than 5. | 4 / 5 |
Total | 18 / 20 Passed |