Content
56%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 curated workflow portion is executable and well-sequenced with verification, but the large auto-generated subcommand reference is padded, duplicated, and partly broken, dragging down conciseness and structure.
Suggestions
De-duplicate and trim the subcommand reference (config list/get/set each appear twice; many entries have no description), and fix the truncated 'config opencode' line.
Move the bulk of the subcommand API reference into a separate references file and link to it from SKILL.md to improve progressive disclosure.
Replace placeholder examples like `omniroute config get <tool>` with at least one realistic concrete argument so examples are truly copy-paste ready.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The auto-generated subcommand section is heavily padded with repeated boilerplate ('**Example:**' + literal `omniroute <cmd>` blocks), duplicated entries (config list, config get, config set appear twice), several subcommands with no description, and a truncated sentence ('Generate OpenCode config (alias for '), making it noticeably verbose. | 2 / 5 |
Actionability | The curated workflow provides copy-paste-ready curl commands, JSON request/response examples, install-path mappings, and verification commands; only minor gaps (placeholder <tool>/<key> args and the broken config opencode text) prevent a 5. | 4 / 5 |
Workflow Clarity | The curated content lays out a clear Detect → Review → Install → Verify sequence with an explicit verification step (Step 4) and a combined quick-start script, with only minor validation gaps keeping it below 5. | 4 / 5 |
Progressive Disclosure | The body has section headers but inlines a long flat subcommand reference that would be better split into a separate file, and no bundle references exist, so structure is present but not well separated. | 3 / 5 |
Total | 13 / 20 Passed |