Content
48%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 router concept is sound — a symptom-to-reference table, a clear decision tree, and genuinely useful anti-rationalization content — but the body states the same routing four times (table, DOT graph, numbered list, example invocations), and its central action ("See skills/accessibility-diag.md") points at files not shipped in this bundle, leaving little executable guidance inside the skill itself.
Suggestions
Eliminate the duplicated routing: keep either the DOT graph or the numbered Decision Tree (not both), and cut the 'Example Invocations' section that restates the Quick Reference table — this alone removes ~40% of the body.
Ship the referenced files (skills/accessibility-diag.md, skills/ux-flow-audit.md, skills/watchos-a11y.md) in the bundle's references/ directory, or inline their key procedures, so the skill's primary pointer resolves within the skill.
For the most common case, add one concrete executable step (e.g., how to actually run `/axiom:audit accessibility` or a short VoiceOver-label code fix pattern) instead of routing every symptom straight to an external file.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Roughly 40% of the body restates the same routing information: the DOT decision graph duplicates the numbered Decision Tree list line-for-line, the 16 "Example Invocations" restate the Quick Reference table, and "Automated Scanning" repeats items 7 and the agent routes. That is several padded/duplicated sections rather than isolated over-explanation, which fits anchor 2 better than 3. | 2 / 5 |
Actionability | Pointers are concrete (specific file paths like `skills/accessibility-diag.md`, agent names, and the `/axiom:audit accessibility` command), and "Critical Patterns" cites real APIs (`Image(decorative:)`, `accessibilityInputLabels()`). But the dominant instruction is "See <file>" where the referenced files are not present in this bundle (no references/ or skills/ directory exists), and there is no executable code or command sequence, so guidance is incomplete — anchor 3. | 3 / 5 |
Workflow Clarity | The numbered Decision Tree (1–7) plus the Quick Reference table gives a clear, unambiguous triage sequence: identify issue type, route to the matching file or agent. Being a non-destructive router, no validation checkpoints are required, and the sequence is essentially complete; it stops short of 5 due to minor ambiguity (e.g., "Check my app for accessibility issues" routes to the diag file while the near-identical "Scan my app" routes to the agent). | 4 / 5 |
Progressive Disclosure | References are one level deep and clearly signaled via the Quick Reference table, but they point to `skills/*.md` files that do not exist in this bundle (verified: no references/, scripts/, assets/, or skills/ directories), so the disclosed structure is not actually realized — every detailed path dead-ends. Cross-suite references (axiom-watchos, axiom-testing) add further navigation friction, matching anchor 3 rather than 4. | 3 / 5 |
Total | 12 / 20 Passed |