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 body that assumes Claude's competence, routes every symptom to a concrete one-level-deep reference, and anticipates skip-behavior with a thoughtful Anti-Rationalization table. Its main costs are the fully duplicated routing in the dot Decision Tree and unverifiable `skills/` reference paths. Fix procedures and validation loops correctly live in the referenced files.
Suggestions
Delete the dot Decision Tree (or the Quick Reference table) — both encode the same symptom→reference mapping, and one format covers the routing need at roughly half the tokens.
Trim long parenthetical rows (navigationSubtitle placements, the Liquid Glass and TextKit scan descriptions) by moving that detail into the referenced files they point to.
Ship the `skills/*.md` files inside the bundle (or under `references/`) so the one-level-deep references resolve, and confirm cross-suite targets (axiom-uikit, axiom-design, axiom-macos, axiom-swift) are installed dependencies.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient — no over-explanation of concepts Claude already knows, and pointers are dense — but the ~28-line dot 'Decision Tree' repeats the same symptom→reference mapping already given in the 32-row 'Quick Reference' table, and verbose rows (the iOS 26 'navigationSubtitle' entry, the long Liquid Glass/TextKit scan parentheticals) could be tightened. It is not 4 because the duplication is an entire redundant section rather than minor trim instances. | 3 / 5 |
Actionability | Routing guidance is concrete and executable: every symptom maps to an exact path ("See `skills/debugging.md`"), with concrete fallback logic ("if `command -v <tool>` finds nothing ... use `<plugin-root>/tools/<tool>`") and a sequenced escalation rule ("Try axiom-swiftui FIRST ... Only use axiom-performance if domain fixes don't help"). Not 5 because the actual fix procedures live in the referenced files rather than here, and placeholder resolution ("two levels above this skill's Base directory") needs interpretation. | 4 / 5 |
Workflow Clarity | The diagnosis workflow is clearly sequenced — symptom lookup → reference, conflict-resolution ordering (1. try domain fixes, 2. escalate), and escalation checkpoints like "View update still broken after debugging → `skills/debugging-diag.md`". Not 5 because explicit post-fix validation steps are deferred to the referenced files; not 3 because sequencing and error-recovery escalation are both present. | 4 / 5 |
Progressive Disclosure | Exemplary router structure: the 'Quick Reference' table and 'Non-SwiftUI UI Routes' section point one level deep to clearly signaled `skills/*.md` targets organized by symptom. Not 5 because no bundle files are provided to verify the `skills/*.md` targets and cross-suite references (axiom-uikit, axiom-design, axiom-macos, axiom-swift) actually exist — the nonstandard `skills/` path is unverifiable in the provided bundle, leaving minor navigation risk. | 4 / 5 |
Total | 15 / 20 Passed |