Content
77%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-structured router skill body with tight, actionable, table-driven guidance and explicit validation checkpoints for parallel dispatch. The main defect is a dangling reference: 'gotchas.md' is named in three places but is not present in the bundle.
Suggestions
Add the missing 'gotchas.md' file to the bundle, or remove/replace its three references (bootstrap step 4, Dependencies, Gotches section) with a pointer to an existing file such as ../x-shared/common-gotchas.md.
Tighten the repeated ≤1-agy-lane and fan-out rule prose — the default-agy-fan-out block and the HARD GATE both restate overlapping sequencing constraints and could be consolidated.
Confirm the ../x-shared/* and ../x-omo/SKILL.md cross-skill references resolve in the deployed plugin, since the routing table depends on them being loadable at bootstrap.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Dense, table-driven, imperative prose that assumes Claude's intelligence and avoids explanatory padding ('x-research is a router. It classifies ... and synthesizes'), though the 159-line body repeats some gate/fan-out rules that could be tightened. | 4 / 5 |
Actionability | Provides concrete, executable invocation forms ('agy-agent --model pro --grounded', 'gitnexus → query', 'mcp__basic-memory__search_notes(...)') and a signal→tool routing table, with only minor gaps where detail is deferred to linked skills. | 4 / 5 |
Workflow Clarity | Sequenced bootstrap, depth calibration, explicit validation checkpoints (read primary before dispatching OMO via the HARD GATE, MANDATORY cost guard before Max dispatch, wait-for-terminal-state before synthesis), and a partial-failure recovery path — clear feedback loops for batch/parallel dispatch. | 5 / 5 |
Progressive Disclosure | SKILL.md is an overview with well-signaled one-level-deep references into references/*.md (all four present), but 'gotchas.md' is referenced in bootstrap step 4, Dependencies, and the Gotchas section yet is absent from the bundle — a dangling reference that breaks navigation. | 3 / 5 |
Total | 16 / 20 Passed |