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.
The body is a lean, well-organized router: a symptom-to-reference table, cross-suite routing, explicit conflict-resolution rules, and a decision tree, with no filler and concrete agent/file/tool pointers throughout. Its weaknesses are duplicated routing content (the decision tree repeats the quick-reference table; cross-suite routes and conflict resolution overlap) and references that resolve only within the parent suite rather than this bundle. Cutting the duplication would make it a model router skill.
Suggestions
Remove the dot-graph Decision Tree — it duplicates the Quick Reference table's task→skill mapping almost exactly, saving ~20 lines with no information loss.
Merge "Cross-Suite Routes" and "Conflict Resolution" into one section, since both explain the same axiom-macos vs axiom-swiftui (and axiom-security) boundary.
Clarify where referenced files live (e.g., a one-line note that "skills/*.md" paths are relative to the Axiom suite root) so navigation works without the surrounding suite's directory layout in context.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | There is no padding or explanation of concepts Claude already knows, but the dot-graph Decision Tree restates the Quick Reference table's routing almost row-for-row (~20 redundant lines), and "Cross-Suite Routes" and "Conflict Resolution" both explain the same axiom-macos vs axiom-swiftui boundary. This fits anchor 3 ("mostly efficient but could be tightened") better than anchor 4's "minor instances". | 3 / 5 |
Actionability | Pointers are concrete and executable — "See `skills/windows.md`", "Launch `touch-auditor` agent or `/axiom:audit touch`", "`axiom_get_agent` returns it" — including a fallback path when agents can't launch. Not anchor 5: most table rows name only a destination file without stating the action to take there, and paths are relative to an unstated suite root. | 4 / 5 |
Workflow Clarity | As a single-purpose routing skill, the one action (match task → follow reference) is made near-deterministic by the symptom table, decision tree, and explicit conflict-resolution rules for overlapping cases, with environment-specific fallbacks for agent launch. Minor residual ambiguity (e.g., the Apple Pay/Catalyst row vs ios-apps-on-mac) keeps it at anchor 4 rather than 5. | 4 / 5 |
Progressive Disclosure | The body is a pure overview/index: all detail is deferred to one-level-deep, clearly signaled references organized by symptom, which is exemplary router structure. However, no bundle files are present — every referenced path ("skills/*.md", "axiom-payments/skills/apple-pay.md") resolves against the surrounding suite rather than this bundle, so navigation is not self-contained; this is anchor 4 (good structure, minor organization gaps) rather than 5. | 4 / 5 |
Total | 15 / 20 Passed |