CtrlK
BlogDocsLog inGet started
Tessl Logo

mimocode-docs

Use whenever the user asks about MiMoCode itself: features, TUI or CLI commands, keybindings, terminal compatibility, rendering glitches, TUI lag, SSH or remote rendering, agent modes (build / plan / compose) and how to switch between them, configuration, file locations, providers, models, authentication, or custom OpenAI-compatible or Anthropic-compatible API endpoints. Especially trigger when a prompt supplies or asks to configure a base URL/baseURL, API key/apiKey, model name or ID, provider, Anthropic Messages API, or global/project mimocode.json/jsonc, or when the user asks how to enter or leave plan mode. Also trigger when a skill, task, subprocess, or external client needs to borrow this instance's models — the OpenAI-compatible /v1 chat endpoints every MiMoCode server serves, `mimo llm-server` task tokens, or how to expose a listening port for them. Use this skill to inspect existing config safely, make minimal changes, and verify them without guessing schema fields or model capabilities.

70

Quality

85%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

71%Weight 40%Scale 1-5

Reviews 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'.

DimensionReasoningScore

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

Description

100%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

An exemplary description: it states explicit what/when, covers a well-bounded product niche, and packs in natural trigger phrasing with synonyms and exact config filenames. Its only weakness is length — it runs long relative to typical skill descriptions — but every clause adds trigger surface rather than padding, so it still lands on the top anchors.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions — "inspect existing config safely, make minimal changes, and verify them", explain features, configure custom API endpoints — with comprehensive coverage of the tool's surface (TUI/CLI commands, keybindings, agent modes, providers, models, authentication, file locations). It matches the anchor 'Lists multiple specific concrete actions; comprehensive coverage' and is not the level below, which requires 'minor gaps in coverage'.

5 / 5

Completeness

It explicitly answers both questions: when via "Use whenever the user asks about MiMoCode itself… Especially trigger when… Also trigger when…", and what via "inspect existing config safely, make minimal changes, and verify them without guessing schema fields or model capabilities". This is the anchor-5 pattern (clear what + concrete trigger phrases); score 4 would require the 'when' to be less explicit, which it is not.

5 / 5

Trigger Term Quality

Trigger terms are comprehensive and include synonyms and exact file spellings users would type: "base URL/baseURL, API key/apiKey, model name or ID, provider, Anthropic Messages API, global/project mimocode.json/jsonc", plus natural phrases like "rendering glitches", "TUI lag", and "how to enter or leave plan mode". This matches the anchor 'Comprehensive coverage of natural terms including synonyms and file extensions' rather than the level below, which tolerates 'a few natural terms missing'.

5 / 5

Distinctiveness Conflict Risk

The niche is clear and product-scoped — every trigger is anchored to "MiMoCode itself", with product-specific tokens (mimocode.json/jsonc, `mimo llm-server`, /compose-next, build/plan/compose modes) that no generic config or provider skill would claim. Distinct triggers with minimal conflict risk matches the top anchor rather than the 'minor overlap risk with closely related skills' anchor.

5 / 5

Total

20

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
XiaomiMiMo/MiMo-Code
Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.