Content
85%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The body is a well-structured router: highly actionable with concrete invoke targets, a clear decision tree, and one-level-deep references to sibling skills. The main weakness is conciseness — the large 'Example Invocations' section duplicates the routing triggers and could be cut or condensed.
Suggestions
Cut or heavily condense the 'Example Invocations' section (lines 317-435): its user-phrasing examples already appear as triggers in 'Routing Logic', so keeping both doubles the token cost with little added routing value.
Trim the repetitive 'Why X' justification paragraphs (e.g. 'Why xcode-debugging first: 90% of mysterious issues are environment, not code') to a single short rationale, or move them into the linked sub-skills.
Fix the out-of-order section numbering — '### 16. Runtime Console Capture' (line 233) precedes '### 15. Code Signing Issues' (line 248) — to keep navigation predictable.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly efficient — structured routing tables and trigger lists rather than concept explanations Claude already knows — but the ~120-line 'Example Invocations' section (lines 317-435) largely duplicates the 'Routing Logic' triggers above it, and repeated 'Why X' justification prose could be trimmed, matching the score-2 anchor of mostly efficient but could be tightened. | 2 / 3 |
Actionability | Routing guidance is concrete and copy-paste ready: explicit invoke paths ('skills/xcode-debugging.md'), slash commands ('/axiom:fix-build', '/axiom:console'), and named agents to launch, plus a numbered decision tree mapping symptoms to specific destinations, matching the score-3 anchor for fully executable, specific guidance. | 3 / 3 |
Workflow Clarity | The 'Decision Tree' provides a clear sequenced triage and the routing logic is well-ordered with a 'When NOT to Use' guardrail acting as a conflict-resolution checkpoint; this router involves no destructive/batch operations requiring validate-fix-retry loops, so it meets the score-3 anchor for clear sequencing with explicit checkpoints. | 3 / 3 |
Progressive Disclosure | The SKILL.md serves as an overview router pointing to one-level-deep, clearly signaled references ('Invoke: skills/xcode-debugging.md', 'See axiom-security (skills/code-signing.md)'), with content appropriately split across sibling skills — matching the score-3 anchor for a clear overview with well-signaled one-level-deep references. | 3 / 3 |
Total | 11 / 12 Passed |