Content
75%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 routing skill: dense, non-obvious domain knowledge (the Anti-Rationalization and Cross-Domain sections), fully concrete directives with exact files, sections, patterns, and APIs, and a clean one-level reference index. The main costs are triplicated routing sections (table + dot graph + numbered list), an inconsistent auditor invocation, and reference paths that do not resolve to any file in the provided bundle.
Suggestions
Remove the dot Decision Tree — it duplicates the numbered Decision Tree entry-for-entry (~25 lines) — and fold Example Invocations into the Quick Reference table to cut roughly a third of the body's tokens without losing any routing information.
Reconcile the auditor routing: replace "Launch: `camera-auditor` agent" in Example Invocations with the `axiom-audit-camera` skill invocation used in step 14 and the inline note, so all three mentions agree.
Ship the referenced files in the bundle (ideally under the standard `references/` directory) so the ~30 `skills/*.md` paths resolve; if they exist only in the parent repo, note that in the SKILL.md so the index is verifiable.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | All content is high-signal — no concept explanations, and the Anti-Rationalization table is dense non-obvious knowledge ("`Song.id` ... differs per device ... never use it as a cross-device key"). But routing information is triplicated: the Quick Reference table ("Camera capture, AVCaptureSession | See `skills/camera-capture.md`"), the dot Decision Tree ("what -> \"skills/camera-capture.md\" [label=\"camera capture\"]"), and the numbered Decision Tree ("1. Camera capture? → `skills/camera-capture.md`") all encode the same mapping — the dot graph is fully redundant with the numbered list. That is a whole section of redundancy, matching anchor 3 ("could be tightened") rather than anchor 4's "minor instances that could be trimmed"; not score 2 because nothing is padded or explains what Claude already knows. | 3 / 5 |
Actionability | Directives are maximally concrete for an instruction-only router: "Read: `skills/camera-capture.md` (Pattern 8, deferred start)", "See `skills/carplay-templates-ref.md`" with named sections and pattern numbers, plus exact API-level fixes ("join your own session via `provider(from:in:)`, or `init(session:analyzerFormat:priority:)`"). Example Invocations ("User: 'My camera app takes a second before preview appears' → Read `skills/camera-capture.md` Pattern 8") cover the common cases. Per the rubric's code-vs-instruction note, absence of code is not penalized when guidance is this specific; not score 4 because no directive lacks the exact file/section/API to act on. | 5 / 5 |
Workflow Clarity | The routing workflow is clearly sequenced: the numbered Decision Tree ("1. Camera capture? → ..."), Cross-Domain Routing resolves boundary cases explicitly ("Now Playing metadata/controls → **stay here** ... Background audio mode → **invoke axiom-integration**"), and Anti-Rationalization catches misdiagnoses. No validation checkpoints are required — routing is read-only, not destructive or batch. Score 4 rather than 5 because the auditor path is inconsistent: Example Invocations say "Launch: `camera-auditor` agent" while the inline note says "invoke the matching Codex skill ... Available: `axiom-audit-camera`" and step 14 says "→ `axiom-audit-camera`". Well above anchor 3 — the sequence is complete and unambiguous. | 4 / 5 |
Progressive Disclosure | The body is a well-signaled, one-level-deep index: "See `skills/camera-capture.md` Patterns 8-9", "See `skills/carplay-templates-ref.md`", each mapped to a symptom row — textbook anchor 5 structure. But scored against the actual bundle: no `references/`, `scripts/`, or `assets/` directories exist, and none of the ~30 referenced `skills/*.md` paths resolve to a file in this bundle, so the references cannot be verified as real and the layout is nonstandard. Anchor 4 ("references mostly clear; minor organization gaps") is the best fit — not 5 because references cannot be confirmed against the bundle structure; not 3 because references are prominently signaled, not buried. | 4 / 5 |
Total | 16 / 20 Passed |