mimo-skill-creator

Skill Creator — MiMo Code

Create skills that extend MiMo Code with specialized workflows. Leverages task, bash, read, write, edit, skill tools natively.

Three Gates (Pre-flight)

All must pass before starting. If any is no → stop.

1. MiMo Code can't already do this well? → Skill is overhead.
2. User will use it 5+ times? → One-shot → direct prompt.
3. Model has it built-in? → Skill adds complexity, not value.

Skill Anatomy

skill-name/
├── SKILL.md          # Required — frontmatter + instructions
├── scripts/          # Optional — executable code
├── references/       # Optional — loaded on demand
└── assets/           # Optional — templates, icons, fonts

Frontmatter — only 3 fields are read by MiMo Code:

name: kebab-case       # Required. Letters, digits, hyphens. Max 64 chars.
description: >         # Required. Max 500 chars. Triggering conditions ONLY.
  Use when [trigger], [trigger], or [symptom].
hidden: true           # Optional. true = loaded but not in available_skills list.

Placement — MiMo Code discovers SKILL.md recursively from:

• Project: .mimocode/skills/**, .claude/skills/**, .agents/skills/**, .codex/skills/**
• Global: ~/.config/mimocode/skills/**, ~/.claude/skills/**, ~/.agents/skills/**
• Config: skills.paths and skills.urls in mimocode.json

The #1 Mistake: Description Trap

When description summarizes the workflow, the model follows the description and skips the body.

# ❌ BAD: Summarizes workflow → model takes shortcut
description: Use for TDD — write test first, watch it fail, write minimal code

# ✅ GOOD: Triggering conditions only → forces model to read the body
description: Use when implementing features or bugfixes, before writing code

Formula: [Action verb] + [value]. Use when [trigger 1], [trigger 2], ... Include 5+ triggers. Add exclusions. Be slightly "pushy".

Creation: 7 Steps

1. Classify Complexity

Tier	SKILL.md	Dirs
Simple	< 150 lines	None
Medium	100-300	scripts/ or references/
Complex	200-650	Multiple