Content
81%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: unambiguous decision tree, symptom-to-reference mapping, explicit cross-domain and conflict routing, and an anti-rationalization table full of non-obvious, version-specific gotchas. The main costs are quadruple-stated routing (table, DOT graph, numbered list, examples) and inline version numbers that aren't quarantined in a deprecation section.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly dense, high-value pointer material with no explanations of concepts Claude already knows, but routing is stated three times over (Quick Reference table, DOT decision tree, numbered decision list, plus Example Invocations), which is real redundancy that could be tightened. It also carries many inline version numbers ("iOS 18+", "iOS 26+", "Xcode 26", "iOS 26.4", "deprecated in the 27 SDKs") that the guidelines penalize when not confined to a deprecated/old-patterns section — the ODR deprecation row is the only one placed in that framing. This lands on anchor 3 ("mostly efficient but... could be tightened"), not 4. | 3 / 5 |
Actionability | As an instruction-only router, every row gives an exact, executable instruction: symptom → exact file path ("My background task never runs" → Read `skills/background-processing-diag.md"), exact agent launches ("Launch `iap-auditor` agent"), and concrete API-level gotchas with the reference to read. Per the scoring notes, absence of code is not penalized when guidance is this actionable; it fully matches anchor 5's copy-paste-ready standard for its genre. | 5 / 5 |
Workflow Clarity | The routing workflow is unambiguous: a decision tree with numbered branches and sub-branches (1–16 with a/b/c variants), plus cross-domain routing and a conflict-resolution section that resolves every overlap ('stay here' vs 'also invoke axiom-X'). No destructive or batch operations exist that would require validation checkpoints, so the simple-skill exception applies and the single action (identify feature → read reference) is fully clear, matching anchor 5. | 5 / 5 |
Progressive Disclosure | References are one level deep, consistently formatted, and surfaced through multiple navigation aids (Quick Reference table, decision tree, examples), matching the good-structure anchor 4. It falls short of 5 because no bundle files exist alongside SKILL.md to verify the ~40 referenced `skills/*.md` paths, and some detail that belongs in those references (e.g., multi-sentence SharePlay GroupSessionMessenger internals in the anti-rationalization table) is inlined in the router itself. | 4 / 5 |
Total | 17 / 20 Passed |