Content
85%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/index skill: complete boundary routing, explicit anti-rationalization traps with concrete facts, and clean one-level-deep disclosure. Its main weakness is token redundancy — the same routing table is effectively presented four times in different formats.
Suggestions
Collapse the redundancy between the Quick Reference table, the dot Decision Tree, the 'Simplified routing' list, and Example Invocations — keep one canonical routing structure (the symptom table) and one decision flow, cutting the other two or trimming them to a handful of non-obvious cases.
Trim Example Invocations to the 4–5 least obvious queries; most entries restate rows already in the Quick Reference table (e.g. 'How do I build a Wallet pass' duplicates the Wallet passes row).
Move the Cross-Suite Routing section's generic deferrals (axiom-design, axiom-macos, axiom-watchos) into the 'When NOT to Use' table to avoid maintaining two overlap tables.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Routing information is restated in four overlapping forms — the Quick Reference symptom table, the dot Decision Tree, the 'Simplified routing' numbered list, and Example Invocations — which is redundant and could be consolidated. Otherwise the body assumes Claude's competence (no basic-concept explanations), so it sits above the verbose anchors but below efficient. | 3 / 5 |
Actionability | Every query shape routes to a specific file path, and the Anti-Rationalization table carries concrete, checkable specifics ('Payment Processing Certificates expire after 25 months', 'Two-step request (dev → distribution)'). Example Invocations cover the common cases end-to-end for a routing skill. | 5 / 5 |
Workflow Clarity | The routing decision is unambiguous and complete: boundary check (Apple Pay vs IAP) → surface → pass type → failure path, with the 'Something not working?' path closing the tree. No destructive or batch operations exist, so the validation cap does not apply, and every branch terminates in a concrete file. | 5 / 5 |
Progressive Disclosure | The body is a pure index: a concise overview, a symptom→file Quick Reference table, and well-signaled one-level-deep references to skills/*.md with no nested reference chains. No bundle files exist in this directory to verify, but the on-page structure matches the clear-overview-with-one-level-references anchor exactly. | 5 / 5 |
Total | 18 / 20 Passed |