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 with clear navigation, explicit conflict-resolution rules, and genuinely useful anti-rationalization content. Its main costs are redundant restatements of the same routing map and references to files and external skills that cannot be verified in the bundle.
Suggestions
Collapse the dot decision graph and the numbered Decision Tree into one routing representation — they duplicate each other almost exactly and cost significant tokens.
Trim the Example Invocations section or merge it into the Quick Reference table, since both map the same user phrasings to the same files.
Normalize the external routing entries (items 6-8) to a consistent, resolvable format and ensure the referenced `skills/*.md` files ship alongside SKILL.md.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body avoids explaining concepts Claude already knows, but the same routing information is restated four times — Quick Reference table, dot decision graph, numbered Decision Tree, and Example Invocations — and the dot graph and numbered list are near-duplicates. Not 2 because each section is individually tight and purposeful rather than padded. | 3 / 5 |
Actionability | Routing guidance is concrete and specific ("Read: `skills/swift-modern.md`", "Use swift for Transferable conformance... -> `skills/transferable-ref.md`"), with per-file content previews that make next steps executable. Not 5 because external routing entries use inconsistent, unresolvable formats ("/skill axiom-concurrency", "axiom-performance (skills/swift-performance.md)") and none of the referenced paths exist in the bundle. | 4 / 5 |
Workflow Clarity | The single routing action is made unambiguous by the decision tree plus explicit conflict-resolution tiebreakers ("Use concurrency, NOT swift", "Use axiom-build first"), which function as validation checkpoints for routing decisions. Not 5 because decision-tree entries 6-8 route to external skills with inconsistent formats and no conflict-resolution coverage. | 4 / 5 |
Progressive Disclosure | References are one level deep, clearly signaled, and organized by symptom and topic ("See `skills/tvos.md"), with the body acting as an overview. Not 5 because the referenced files (skills/swift-modern.md, skills/ownership-conventions.md, etc.) do not exist in the bundle, so the navigation cannot be verified to resolve. | 4 / 5 |
Total | 15 / 20 Passed |