Kimi Code — Skills
Una skill es un archivo Markdown con frontmatter YAML que describe conocimiento reutilizable o un flujo de trabajo. Se pueden invocar a mano con un comando slash, o automáticamente por el modelo.
Estructura de los archivos
Hay dos formas:
- En directorio (recomendada):
<nombre>/SKILL.mdmás sus archivos de apoyo. - Plana:
<nombre>.md.
Si las dos existen en el mismo directorio, gana la de directorio.
Campos del frontmatter: name (obligatorio en la forma de directorio; no distingue mayúsculas), description (obligatorio en la forma de directorio; en la plana se usa la primera línea no vacía del cuerpo, hasta 240 caracteres), type (prompt por defecto / inline (igual que prompt) / flow (sólo invocación manual)), whenToUse (también when-to-use, when_to_use), disableModelInvocation y arguments (array o separados por espacios; se usan en el cuerpo como $<nombre>).
Marcadores del cuerpo: $ARGUMENTS, $ARGUMENTS[0]/$0, $1… (posicionales, admiten comillas), $<nombre> (los argumentos declarados) y ${KIMI_SKILL_DIR}. Si no hay ningún marcador, el texto de la invocación se añade al final como \n\nARGUMENTS: <texto>.
Ubicaciones
Prioridad: Proyecto > Usuario > Extra > Integradas.
| Ámbito | Ubicación |
|---|---|
| Usuario | $KIMI_CODE_HOME/skills/ (por defecto ~/.kimi-code/skills/) y ~/.agents/skills/ |
| Proyecto | .kimi-code/skills/ y .agents/skills/ |
| Extra | extra_skill_dirs en config.toml (se suman); el flag --skills-dir (sustituye el descubrimiento automático en ese arranque; repetible) |
| Integradas | Vienen con el CLI (la prioridad más baja); las skills de producto se activan o desactivan con builtin_product_skills |
merge_all_available_skills (en la configuración, true por defecto) controla si se fusionan las skills de todos los directorios disponibles.
Cómo se invocan
- Manual:
/skill:<nombre> [texto adicional]; la forma corta/<nombre>funciona cuando el nombre no lo ocupa un comando del sistema; las sub-skills aparecen como/<padre>.<sub>. - Automática: el modelo invoca las skills de tipo
inlinecon la herramientaSkill(se bloquea condisableModelInvocation: true; profundidad máxima de anidamiento: 3). - Las skills de tipo
flowson sólo manuales, pero siguen apareciendo como/skill:<nombre>. - Los comandos de skill que escribes mientras el agente trabaja se encolan;
Ctrl-Smete un comando encolado en el turno en marcha. Cualquier/...que no coincida con nada se le manda al agente como un mensaje normal.
Skills integradas
Se invocan como /<nombre> (sin el prefijo skill:, y sólo con el agente parado):
| Comando | Para qué sirve |
|---|---|
/mcp-config | Configura servidores MCP y el login OAuth de MCP (ver MCP) |
/custom-theme [<texto>] | Crea o edita un tema de la TUI |
/update-config | Inspecciona y edita config.toml/tui.toml |
/check-kimi-code-docs | Responde preguntas del producto a partir de la documentación oficial |
/import-from-cc-codex | Importa instrucciones, skills y ajustes de MCP de Claude Code y Codex |
/sub-skill | Y también /sub-skill.review y /sub-skill.consolidate |
Ejemplo
~/.kimi-code/skills/commit-msg/SKILL.md:
---
name: commit-msg
description: Redacta un mensaje de Conventional Commits para los cambios en stage
whenToUse: Cuando el usuario pide un mensaje de commit
arguments: [scope]
---
Revisa `git diff --staged` y redacta un único mensaje de Conventional Commits.
Usa el scope `$scope` si te lo dan. Devuelve sólo el mensaje, sin explicaciones.
Para invocarla:
/skill:commit-msg api
Última verificación: 2026-09-07
Fuentes oficiales:
- https://www.kimi.com/code/docs/en/kimi-code-cli/customization/skills.html
- https://www.kimi.com/code/docs/en/kimi-code-cli/reference/slash-commands.html
- https://www.kimi.com/code/docs/en/kimi-code-cli/configuration/config-files.html
Las herramientas de IA para programar evolucionan rápido. Si encuentras información desactualizada, abre un issue o un pull request.