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.
The body is highly actionable and lean, with concrete commands, error feedback loops, and clear routing. The main defect is progressive disclosure: the skill points to seven detail files but only one exists, leaving most reference links dangling.
Suggestions
Add the missing referenced files (agents/oracle.md, agents/explore.md, agents/librarian.md, agents/multimodal-looker.md, models-routing.md, gotchas.md) or remove/inline the dangling links so every referenced path resolves.
Consolidate the three overlapping routing tables (Agent Catalog, When to Use Which Agent, User Intent Routing) into one or two to tighten conciseness.
Lay out the dispatch lifecycle as a single numbered checklist with explicit validation checkpoints (invoke → set timeout → collect all results → verify any file changes → synthesize) rather than distributing it across sections.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Information-dense with tables and executable commands and no padding about concepts Claude already knows, but the Agent Catalog, When-to-Use, and User Intent Routing tables overlap noticeably and could be consolidated. Not 5 because the redundant routing tables are more than trivially trimmable; not 3 because the body is genuinely lean and never explains basics. | 4 / 5 |
Actionability | Fully executable, copy-paste-ready commands ("omo-agent oracle \"prompt\"", "--model <alias>", "--file /path", timeout 600000, run_in_background) cover role agents, model routing, file/skill attach, and parallel dispatch, plus an error-string→resolution map. Matches the anchor for copy-paste-ready commands covering common cases; not 4 because coverage is comprehensive rather than having minor gaps. | 5 / 5 |
Workflow Clarity | A clear dispatch lifecycle (quick-dispatch rule → invoke → set timeout → choose execution mode → collect → synthesize) with an exit-code feedback loop (non-zero → diagnose → retry with correct agent) and a verify-after-modification step. Not 5 because the sequence is distributed across sections rather than one explicit numbered checklist with checkpoints; not 3 because validation and feedback loops are present. | 4 / 5 |
Progressive Disclosure | The SKILL.md is well-sectioned and signals one-level-deep references clearly, but scoring against the actual bundle, 6 of 7 referenced files (agents/oracle.md, agents/explore.md, agents/librarian.md, agents/multimodal-looker.md, models-routing.md, gotchas.md) do not exist — only references/prompt-blocks.md is present, so the disclosure path breaks for most routes. Not 4 because broken/dangling references mean navigation does not actually work; not 2 because the in-skill structure and signaling are good, not minimal. | 3 / 5 |
Total | 16 / 20 Passed |