Content
66%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-designed router body: unambiguous routing with explicit conflict resolution and no padding with known concepts. Its critical flaw is that every referenced skills/*.md file is missing from the bundle, so the skill cannot deliver its referenced content; secondary flaws are a duplicated decision tree and repeated routing tables.
Suggestions
Ship the referenced files (`skills/swift-modern.md`, `skills/ownership-conventions.md`, `skills/transferable-ref.md`, `skills/deep-link-debugging.md`, `skills/tvos.md`, `skills/swift-simplifier.md`) inside the bundle so the routing targets resolve.
Drop either the dot-graph decision tree or the numbered list — they duplicate each other line for line — to cut tokens without losing lookup ability.
Consolidate the Quick Reference table and Example Invocations into one routing section; the same five mappings appear in both.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body avoids explaining concepts Claude already knows and is mostly pointers, but the same routing information is restated four times (Quick Reference table, dot graph, numbered decision tree, Example Invocations), and the dot graph exactly duplicates the numbered list. Mostly efficient, but noticeably could be tightened. | 3 / 5 |
Actionability | Routing guidance is concrete and executable — exact file pointers per situation ("Read: `skills/transferable-ref.md`"), a concrete agent command ("`/axiom:audit swift-simplify`"), and 12 worked user-to-reference examples. Minor gaps: the agent fallback path ('search Axiom's skills for `skills/<agent>.md`') is a search instruction rather than an exact path. | 4 / 5 |
Workflow Clarity | This is a single-purpose router skill and the single action — route to the correct reference file — is unambiguous, supported by three lookup mechanisms (table, decision tree, examples) plus explicit conflict-resolution rules for edge cases. The simple-skill exception applies; no destructive or batch operations require validation checkpoints. | 5 / 5 |
Progressive Disclosure | References are clearly signaled and one level deep by design, but none of the six referenced files (`skills/swift-modern.md`, `skills/ownership-conventions.md`, `skills/transferable-ref.md`, `skills/deep-link-debugging.md`, `skills/tvos.md`, `skills/swift-simplifier.md`) exist in the bundle — no references/, scripts/, or assets/ directories are present. Navigation fails at the first hop as bundled, matching anchor 2 rather than 3 (the problem is existence, not signaling). | 2 / 5 |
Total | 14 / 20 Passed |