Content
75%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/index skill: every symptom routes to a concrete file, agent, or command, with clear escalation and conflict-resolution procedures. Its weaknesses are presentational redundancy (the routing table is duplicated as a dot decision tree) and reference targets that are not resolvable within the skill's own bundle directory.
Suggestions
Drop one of the two routing mechanisms — the 'dot' Decision Tree duplicates ~20 rows of the Quick Reference table — or move the generated tree into a referenced file, keeping a single canonical index in SKILL.md.
Trim the Anti-Rationalization table's detailed technical caveats (e.g. the Xcode 27 '@State' row's private/deployment-target conditions and TN311 breaks) to one-line pointers into skills/architecture.md, keeping only the myth and the reference.
Make the `skills/*.md` reference targets resolvable from the skill's own bundle (e.g. place them under references/ or state the plugin-root-relative resolution rule once at the top) so the index can be verified and navigated standalone.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is a dense router that mostly avoids explaining known concepts, but it could be tightened: the 'dot' Decision Tree duplicates roughly 20 rows of the Quick Reference table in a second format, and Anti-Rationalization rows embed detailed technical caveats (e.g. the Xcode 27 '@State is lazy' row's private/deployment-target gating and TN3211 references) that belong in the referenced files. This fits anchor 3 ('mostly efficient but could be tightened') better than anchor 4's 'minor instances'. | 3 / 5 |
Actionability | As an instruction/router skill, every entry gives a concrete, executable destination: named files ('See `skills/nav.md`'), named agents ('Launch `swiftui-nav-auditor` agent'), or copy-paste commands ('/axiom:audit swiftui-performance', '/skill axiom-accessibility'). Specific examples cover the common cases, matching anchor 5. | 5 / 5 |
Workflow Clarity | Routing is unambiguous via the symptom-to-reference table, with explicit escalation paths ('View update still broken after debugging → `skills/debugging-diag.md`') and an ordered conflict-resolution procedure with a check-before-escalate condition ('Only use axiom-performance if domain fixes don't help'). Minor gaps — not every table row has an escalation path and no guidance for multiple co-occurring symptoms — keep it at anchor 4 rather than 5. | 4 / 5 |
Progressive Disclosure | The body is a well-sectioned index (Quick Reference, Non-SwiftUI Routes, Conflict Resolution, Decision Tree, Automated Scanning, Anti-Rationalization) with clearly signaled one-level references ('See `skills/layout.md`') and explicit out-of-scope routing to sibling suites. However, the `skills/*.md` targets do not exist within this skill's bundle (no references/ or skills/ directory alongside SKILL.md), so the split cannot be verified against actual files — anchor 4 ('good structure, minor organization gaps') rather than anchor 5. | 4 / 5 |
Total | 16 / 20 Passed |