Content
43%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 functions as a scannable command reference with real command names, but it reads like unedited generator output: duplicated subcommand sections, placeholder-only examples, a truncated sentence, and no workflow or validation guidance. It tells Claude what commands exist but not how to sequence them or how to recover from mistakes.
Suggestions
Deduplicate the repeated `config get`, `config set`, and `config list` sections and fix the truncated "Generate OpenCode config (alias for" sentence.
Replace placeholder-only examples with at least one worked example per non-trivial command (e.g., `omniroute config set claude --model sonnet --yes`) and briefly state what each flag does.
Add a short workflow section: run `setup` first, use `config validate <tool>` before `config set`, and `update --check` / `--dry-run` before `--apply`, with what to do when validation fails.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body has no padded prose, but it wastes tokens on duplication and empty examples: `config get`, `config set`, and `config list` each appear twice, and most "Example" blocks (e.g., the five `autostart` variants) merely restate the heading verbatim, adding no information. This is noticeably below the lean every-token-earns-its-place anchor and sits in the could-be-tightened range. | 3 / 5 |
Actionability | Real commands are given, but the examples are the bare command with unsubstituted placeholders (e.g., `omniroute config set <tool>` with `--model <model>` and no worked example), and "Generate OpenCode config (alias for" is a truncated, incomplete sentence. Concrete guidance exists but is incomplete with missing key details, rather than mostly-executable with only minor gaps. | 3 / 5 |
Workflow Clarity | There is no sequencing guidance for the inherently multi-step flows (initial `setup` before `config set`, `config validate` before writing), no validation checkpoints despite `config validate` and `update --dry-run` existing as commands, and destructive/batch-style config writes lack any feedback loop. Structure exists (commands grouped by subcommand) so it is above the incoherent anchor at 1, but steps and checkpoints are largely absent. | 2 / 5 |
Progressive Disclosure | The section structure (## Subcommands with ### per command) is clear, but the ~270-line flat reference has no external files to offload detail, repeats three subcommand sections, and buries unexplained flags in lists. This matches the some-structure-but-could-be-better-organized anchor rather than the well-signaled one-level-deep-references anchor at 4. | 3 / 5 |
Total | 11 / 20 Passed |