Content
78%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.
An exemplary router-style SKILL.md: lean, symptom-indexed, with all detail correctly deferred to clearly signaled one-level-deep references and explicit conflict-resolution rules for overlapping suites. The remaining gains are small — de-duplicating the decision tree and specifying how to invoke the touch auditor.
Suggestions
Trim duplication: the dot decision tree repeats the Quick Reference table row-for-row — keep one, or reduce the tree to the ambiguous cases the table handles poorly.
Specify how to invoke `axiom-audit-touch` (exact command or skill-invocation syntax) instead of only listing it as "Available".
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is a dense symptom-to-file routing table plus conflict rules that assumes Claude's competence and explains nothing it already knows. Minor trims remain: the dot decision tree largely duplicates the Quick Reference table, and "You MUST use this skill for ANY macOS-specific development…" restates the frontmatter description. | 4 / 5 |
Actionability | Mostly concrete routing — e.g. "Another team's app or app group container access denied without a prompt (`OS27`)" maps to an exact file, and rows like "See `skills/sandbox-and-file-access.md`" give unambiguous pointers. The gap keeping it from a 5 is the auditor block, which only says "Available: `axiom-audit-touch`" without specifying how to invoke it. | 4 / 5 |
Workflow Clarity | The Decision Tree provides a clear branching sequence and the Conflict Resolution section gives explicit tie-break rules ("Use axiom-macos for macOS-only concerns… Use axiom-swiftui for cross-platform SwiftUI"). No validation checkpoints exist, though none are needed for a read-only router, and the auditor invocation is underspecified — so it sits at 4 rather than 5. | 4 / 5 |
Progressive Disclosure | The body is a pure overview: every detailed topic sits behind a clearly signaled, one-level-deep reference ("See `skills/windows.md`", "See `skills/direct-distribution.md`", cross-suite routes labeled by suite), and nothing that belongs in a separate file is inlined. Navigation via the symptom table, cross-suite routes, and decision tree is easy. | 5 / 5 |
Total | 17 / 20 Passed |