CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

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) 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.

Quality

89%

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

78%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-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.

DimensionReasoningScore

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

Description

95%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.

A dense, trigger-rich description that clearly delimits a niche (the MiMoCode tool itself) and gives explicit 'Use whenever' guidance with synonyms, spelling variants, and file names. The 'what' (inspect, minimally change, verify config; answer feature questions) is explicit but comparatively brief next to the very long trigger inventory, which is the only soft spot.

DimensionReasoningScore

Specificity

Concrete actions are named — "inspect existing config safely, make minimal changes, and verify them without guessing schema fields or model capabilities" — alongside a enumerated feature surface ("TUI or CLI commands, keybindings, terminal compatibility, rendering glitches, TUI lag, SSH or remote rendering, agent modes (build / plan)"). Not 5 because the 'what' side is thinner than the extensive trigger list (the core 'explain features' action is only implied by 'asks about MiMoCode itself'); not 3 because it goes well beyond 1-2 generic actions.

4 / 5

Completeness

Explicitly answers both: 'when' via "Use whenever the user asks about MiMoCode itself" plus two more trigger sentences, and 'what' via "inspect existing config safely, make minimal changes, and verify them". Not 4 because both what and when are explicit with concrete trigger phrases, mirroring the 5-anchor example structure.

5 / 5

Trigger Term Quality

Comprehensive natural-term coverage with synonyms and spelling variants users would actually type: "base URL/baseURL, API key/apiKey", "mimocode.json/jsonc", "TUI lag", "rendering glitches", "SSH or remote rendering", "how to enter or leave plan mode", "mimo llm-server". Not 4 because it explicitly includes variants and file extensions, matching the top anchor rather than leaving 'a few natural terms missing'.

5 / 5

Distinctiveness Conflict Risk

A clear niche — MiMoCode itself — with distinct triggers unlikely to fire for other skills: "mimocode.json/jsonc", "mimo llm-server", "MiMoCode", "agent modes (build / plan)". Not 4 because the unique product-specific tokens give minimal overlap risk with any generic skill.

5 / 5

Total

19

/

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

Path

packages/cli/src/skill/builtin/.bundle/mimocode-docs/SKILL.md

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.