Content
71%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-organized, information-dense instruction skill: it routes by topic, gives exact paths and commands, and encodes a careful 7-step configuration procedure with secret redaction. Its main defects are that every routed reference file is missing from the bundle, the validation step in the configure workflow names no command and has no failure/retry loop, and the routing and how-to sections duplicate each other.
Suggestions
Ship the referenced bundle files (references/providers.md, config.md, guide.md, commands.md, permissions.md, mcp-sampling.md, capability-api.md, workflows.md) or rewrite the routing section to be self-contained — every route currently points to a file that does not exist, so progressive disclosure never pays off.
Add a feedback loop to the 'Helping the User Configure' workflow: when the validation command fails, instruct the agent to fix the config and re-validate before reporting, instead of validating once with no failure path.
Name the exact validation command(s) in step 7 (e.g., the specific `mimo` subcommand that validates a config) and trim the duplicated guide.md/workflows.md routing between 'Reference routing' and 'How-To Guide'.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and assumes competence — a feature map, config discovery rules, and a numbered procedure with no basic-concept padding — matching 'Efficient; minor instances of over-explanation that could be trimmed'. It is not a 5 because there is real duplication: "Reference routing" and "How-To Guide" each route the same guide.md and workflows.md content, and the four built-in workflow bullets detail material that the routing section already delegates to @reference/workflows.md. | 4 / 5 |
Actionability | Mostly concrete and executable: exact paths (`.mimocode/mimocode.json`, `~/.config/mimocode/mimocode.jsonc`), commands (`mimo llm-server issue`, `/goal`, `/compose-next`), a copy-paste JSONC snippet, and a 7-step edit procedure. It falls short of 'fully executable' because key specifics are deferred to references — 'Validate the parsed configuration with the narrowest relevant command' never names that command, and the redaction rule lists key patterns but no concrete redaction example. | 4 / 5 |
Workflow Clarity | The configure workflow is a clear 7-step sequence with scope determination, secret redaction, and a final validation-and-report step — 'Clear sequence with most checkpoints present'. It is not a 5 because the validation step has no feedback loop: nothing says what to do when the validation command fails (fix and re-validate), and for an edit-user-config workflow that error-recovery checkpoint is the missing piece. | 4 / 5 |
Progressive Disclosure | The body's structure and signaling are excellent — a topic-to-file routing section with one-level-deep, clearly named references — but none of the routed files (@reference/providers.md, config.md, guide.md, commands.md, permissions.md, mcp-sampling.md, capability-api.md, workflows.md) exist in the bundle; no references/, scripts/, or assets/ directory is present. As written the navigation is broken, which drops it to 'some structure but could be better organized' territory rather than rewarding routing links that resolve to nothing. | 3 / 5 |
Total | 15 / 20 Passed |