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-built router skill: the question→file table, tool-fallback logic, and Resources map are concrete and easy to navigate. The main costs are the padded, auto-inlined discipline block that repeats one injunction many ways and inconsistent reference formatting for the axiom-build target.
Suggestions
Trim the inlined session block to its decision content: drop the all-caps 'EXTREMELY-IMPORTANT' exhortation, the 'This is not negotiable...' sentence, and collapse the 11-row Red Flags table to the few thoughts not already covered by the priority list and project-detection rules.
Move the full Axiom discipline (priority order, multi-domain examples, red flags) into its own referenced file (e.g. skills/axiom-discipline.md) and keep a 3-4 line summary plus the link in SKILL.md, matching how the other routers are deferred.
Standardize the build-performance reference as a proper link like the other rows (e.g. [skills/build-performance.md](skills/build-performance.md)) instead of the ambiguous 'axiom-build (skills/build-performance.md)' pseudo-target, and mention device-control/screenshot triggers in the frontmatter description so those queries surface the skill.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The routing table, Device Hub note, and Resources section are lean, but the ~95-line inlined session block carries substantial rhetorical padding — 'This is not negotiable. This is not optional. You cannot rationalize your way out of this', an 11-row 'Red Flags' table policing the model's own thoughts, and 'check first' repeated in nearly every row — that restates one rule many times. Mostly efficient with clear tightening opportunities; not 2 because most of that block still encodes usable routing/priority rules. | 3 / 5 |
Actionability | Concrete, executable guidance throughout: 'command -v <tool>' availability check with the '<plugin-root>/tools/<tool>' fallback, a question→file routing table with named sections and a concrete command ('xcui resize sweep'), and explicit MCP tool families ('axiom_xclog_*', 'axiom_xcsym_*', 'axiom_xcprof_*'). Not 5: most tool usage is deferred to refs with no inline example invocations, and the 'Read axiom-build' target lacks a resolvable path. | 4 / 5 |
Workflow Clarity | The router workflow is unambiguous — detect topic, read the named ref, follow it — with an explicit fallback chain for agent launch (MCP axiom_get_agent → file search → do the work yourself) and clear multi-domain routing examples. Not 5 because reference formats are inconsistent ('skills/xclog-ref.md' links vs. the awkward 'axiom-build (skills/build-performance.md)' pseudo-target appearing twice), which leaves minor gaps in the follow-the-instruction path. | 4 / 5 |
Progressive Disclosure | The routing table and Resources section are a textbook one-level-deep router with well-signaled references, but the ~95-line behavioral session block is inlined in SKILL.md where it clearly belongs in a separate file, and the referenced skills/*.md files are not verifiable within this bundle (no references/ or skills/ directory present). Good structure overall with minor organization gaps; not 5 due to the inlined block, not 3 because navigation is easy and references are clearly signaled. | 4 / 5 |
Total | 15 / 20 Passed |