Content
85%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.md: dense with non-obvious domain knowledge, unambiguous routing via three reinforcing navigation structures, explicit cross-domain disambiguation, and one-level-deep references throughout. The only real costs are triple-stated routing mappings and reliance on the surrounding suite's file layout to resolve the referenced paths.
Suggestions
Collapse the redundancy between the Quick Reference table, the numbered Decision Tree, and Example Invocations — e.g., keep the table and examples but drop the numbered list, which repeats the table's mappings almost 1:1.
Add one line near the top explaining how to locate the `skills/*.md` files when this skill is used outside its bundle (the inline auditor block does this for camera-auditor only).
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and assumes competence — no concept explanations (nothing teaches what AVFoundation or a haptic is), and the Anti-Rationalization table carries genuinely non-obvious, hard-won knowledge ("its *format* differs per device for the same library (`i.…` on one, bare numeric on another)", "a suspension never ended hangs the whole group"). It stops short of 5 because the Quick Reference table, the numbered Decision Tree, and Example Invocations restate largely the same ~25 routing mappings three times — a real trimming opportunity even if intentional redundancy for a router. | 4 / 5 |
Actionability | Directives are concrete and specific: "Read: `skills/camera-capture.md` (Pattern 8, deferred start)", "Launch `camera-auditor` agent", and API-level instructions like "hand-rolling reinvents startup barriers... `AVDelegatingPlaybackCoordinatorPlayCommand.hostClockTime` gives you an absolute `CMClockGetHostTimeClock()` start time". It sits at 4 rather than 5 because resolving the `skills/*.md` paths depends on suite context (the inline block explains this for one agent only), and a few entries point at pattern/section numbers without a fallback when the file isn't found. | 4 / 5 |
Workflow Clarity | The routing workflow — identify the media feature, then read the matching reference — is unambiguous and reinforced by three complementary structures (symptom table, decision tree with a dot graph, numbered list). The Cross-Domain Routing section explicitly disambiguates every multi-domain case with "stay here" vs "invoke axiom-X", and Example Invocations map common user phrasings to actions. No destructive or batch operations exist, so the validation cap doesn't apply; the single action is unambiguous, matching the simple-skill exception. | 5 / 5 |
Progressive Disclosure | The body is a pure, well-organized index: ~25 one-level-deep `skills/*.md` references, each clearly signaled with what it covers ("Camera freezes, black preview, rotation → See `skills/camera-capture-diag.md`"). No content that belongs in a separate file is inlined — even the Anti-Rationalization table is router bait (trigger phrases for wrong assumptions) rather than inlined detail. No bundle files were provided to verify against, so this is scored on the body's structure, which matches the 5 anchor: clear overview, well-signaled one-level-deep references, easy navigation. | 5 / 5 |
Total | 18 / 20 Passed |