Content
67%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.
A well-structured router skill: concrete request→file mappings, explicit conflict-resolution rules, and a genuinely useful anti-rationalization table. Its weaknesses are the four-fold repetition of the same routing map (table, digraph, numbered tree, examples) and unverifiable reference paths in the provided bundle. Collapsing the duplicated sections would improve token efficiency without losing any routing signal.
Suggestions
Merge the dot digraph and numbered Decision Tree into one representation (keep the numbered list; drop the digraph, or vice versa) — they duplicate each other and the Quick Reference table verbatim.
Trim the Example Invocations section to cases not already covered by the Quick Reference table, or fold it into the table as an extra column.
Standardize the invocation convention for external resources (pick one of "/skill X", "See X", or "X suite") and state the actual path convention for the skills/*.md files so navigation works from the bundle alone.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | There is no padding prose or explanation of concepts Claude already knows, but the same routing information is repeated four times: the Quick Reference table, the dot digraph, the numbered Decision Tree, and the Example Invocations section all map the identical symptom→file pairs. Anchor 3 ("mostly efficient but could be tightened") fits — the dot graph and Examples sections are pure duplication of the table; not anchor 2 since everything present is functional routing content, not fluffy explanation. | 3 / 5 |
Actionability | Concrete and executable for a router skill: the Example Invocations map exact user requests to specific files, the Quick Reference maps symptoms to files, and Conflict Resolution gives specific error-message heuristics ("CODESIGN, ITMS-90xxx, errSec → security"). Not a 5 because of minor gaps: the CLI commands are only named ("security find-identity, security cms -D") rather than shown, and routing conventions are inconsistent ("/skill axiom-shipping" vs "See axiom-build" vs "axiom-payments suite"). | 4 / 5 |
Workflow Clarity | The routing decision process is unambiguous and reinforced from multiple angles (table, tree, conflict resolution, examples), covering fallbacks like signing-error ownership and the automated-scanner delegation. Not a 5 because no fallback is specified for tasks that match no branch, and mixed invocation styles ("/skill X", "See X", "X (Agent)") leave minor ambiguity about how to actually invoke the external suites and subagent. | 4 / 5 |
Progressive Disclosure | The body is exactly the anchor-5 pattern — a concise overview with well-signaled, one-level-deep references ("See skills/keychain.md", each with a stated purpose in the Quick Reference and Critical Patterns). It drops to 4 because the referenced files could not be verified: the bundle contains only SKILL.md (no references/, scripts/, or skills/ directories), and many pointers route laterally to other suites (axiom-vision, axiom-payments, axiom-build), which is appropriate for a router but leaves navigation partially unverifiable from this bundle. | 4 / 5 |
Total | 15 / 20 Passed |