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.
A well-structured, information-dense overview skill: an accurate feature map, a topic-to-reference routing table, and a disciplined 7-step configuration procedure with redaction and validation checkpoints. The main improvable areas are redundancy across routing sections, an unnamed validation command, and a missing validation-failure recovery loop.
Suggestions
Consolidate reference routing: @reference/guide.md and @reference/workflows.md are each referenced in 'Reference routing', 'How-To Guide', and the feature map — keep the routing table as the single source and drop the repeats.
Name the concrete validation command in step 7 of 'Helping the User Configure' (e.g., the specific `mimo` subcommand that validates a config) so the procedure is fully executable without consulting a reference.
Add a short error-recovery branch to the config procedure (validation fails → read the error → fix → re-validate) to close the feedback loop.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Nearly everything is tool-specific facts Claude cannot know (feature map, file locations, config merge rules) with no padding about general concepts — efficient overall. Not 5 because of duplicated routing: @reference/guide.md and @reference/workflows.md are each pointed to in 'Reference routing', again in 'How-To Guide', and guide.md a third time in the feature map, and on-disk locations appear in both 'Configuration Basics' and 'Where Things Live On Disk'. Not 3 because there is no unnecessary explanation, only redundancy that could be tightened. | 4 / 5 |
Actionability | Concrete throughout: exact paths (`.mimocode/mimocode.json`, `~/.config/mimocode/mimocode.jsonc`), exact commands (`/vivid`, `/goal`, `mimo llm-server issue`), a copy-paste JSONC snippet with `$schema`, and a 7-step config-change procedure. Not 5 because of minor gaps — the validation command is never named ("Validate the parsed configuration with the narrowest relevant command") and the recent-model merge steps are deferred to a reference — which fit the 'concrete commands with minor gaps' anchor; not 3 because the guidance is specific and executable, not high-level hints. | 4 / 5 |
Workflow Clarity | 'Helping the User Configure' is a clearly sequenced 7-step procedure with explicit checkpoints: read the routed reference first, determine scope, inspect only exact candidates, redact secrets, edit minimally, validate, and report which files changed. Not 5 because there is no error-recovery branch (what to do when validation fails) and the validation command itself is unspecified; not 3 because validation and safety checkpoints are explicit and well placed, and the operations are not destructive/batch so no cap applies. | 4 / 5 |
Progressive Disclosure | The body is a genuine overview: a feature map, config basics, and a dedicated 'Reference routing' section that maps each topic to exactly one @reference/*.md file, one level deep, with no nested references (the deepest hop is a single pointer like "(see @reference/guide.md)"). No bundle files were present in the evaluation directory to verify the paths exist, but the structure itself matches the top anchor: clear overview, well-signaled one-level references, easy navigation. Not 4 because every reference is unambiguously signaled by topic and none is buried. | 5 / 5 |
Total | 17 / 20 Passed |