Content
92%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 skill: concrete file-level pointers keyed to symptoms and literal error strings, explicit conflict-resolution tie-breakers, and a clean one-level reference structure with no concept-explanation padding. The only real cost is redundancy — the routing map is restated four times (table, dot graph, numbered list, examples), and the dot graph is the clearest candidate for deletion.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and fluff-free — no concept explanations Claude already knows, and the Anti-Rationalization table is high-value non-obvious domain knowledge (e.g., 'GroupSession is not Sendable', 'deliveryMode is a let fixed at init'). The trimmable part is duplication: the same routing map appears four ways (Quick Reference table, dot graph, numbered Decision Tree, Example Invocations), with the ~30-line dot graph adding nothing over the numbered list. Efficient with minor instances that could be trimmed — anchor 4, not 5, because every token does not earn its place. | 4 / 5 |
Actionability | Every routing entry gives a concrete, executable directive with an exact target path ('Siri playback in an audio app ("play X in MyApp") ... → See skills/siri-audio.md'), and triggers include literal error strings users will paste ('Missing required parameter', 'hasn\u0027t added support for that with Siri', 'I can\u0027t play that'). Example Invocations map real user utterances to specific files. For an instruction-only routing skill this is copy-paste-ready guidance covering the common cases — anchor 5. | 5 / 5 |
Workflow Clarity | The skill's single action — route to the right reference — is unambiguous, and it is supported by layered disambiguation: the numbered decision tree with sub-branches (1a/1b/1c), Cross-Domain Routing for tasks spanning multiple skills, and an explicit Conflict Resolution section that tie-breaks overlaps with axiom-build/axiom-data/axiom-media (the routing equivalent of validation checkpoints). No destructive or batch operations exist, so the validation cap does not apply; the routing decision process could not be much clearer. | 5 / 5 |
Progressive Disclosure | The SKILL.md is a pure overview/router: all implementation detail lives in clearly signaled, one-level-deep references ('See skills/extensions-widgets.md', 'See skills/storekit-ref.md') organized into a scannable symptom table — exactly the anchor-5 pattern. Each Anti-Rationalization row that carries inline API detail ends by pointing to its reference file, keeping the overview an overview. Note: no bundle files were provided in this review copy, so the skills/*.md targets could not be verified against actual file listings; the score reflects the structure as written. | 5 / 5 |
Total | 19 / 20 Passed |