¿Qué es un archivo SKILL.md?
SKILL.md es el único archivo obligatorio de una skill: un frontmatter YAML con el nombre y la descripción, seguido del procedimiento escrito en markdown. El agente lee la descripción siempre y el cuerpo solo cuando decide activar la skill.
- Área
- Fundamentos
- Última revisión
También: skill.md · Archivo de skill
En corto
- El frontmatter necesita dos campos: `name` y `description`.
- La descripción es el único texto que el agente tiene delante cuando decide si la skill le sirve.
- El cuerpo es markdown normal: encabezados, listas, bloques de código y enlaces a los archivos de `references/`.
La estructura mínima
El archivo abre con tres guiones, los dos campos del frontmatter y otros tres guiones. Debajo va el procedimiento. Un `SKILL.md` de veinte líneas es perfectamente válido, y en general uno corto se activa mejor que uno largo: cuanto más concreta es la tarea, más fácil le resulta al agente saber cuándo aplicarla.
La convención habitual es abrir el cuerpo con una sección de «cuándo usar esta skill» y seguir con los pasos numerados. No es obligatorio, pero resuelve el fallo más común: una skill que se activa en el momento equivocado porque nunca dijo en qué momento sirve.
Dónde se coloca
El archivo vive en una carpeta con el nombre de la skill, y esa carpeta va dentro del directorio de skills del agente. En Claude Code es `.claude/skills/` en el proyecto o `~/.claude/skills/` para toda la máquina. Otros agentes usan rutas propias, y los instaladores las resuelven con un flag.
El nombre de la carpeta y el campo `name` del frontmatter deben coincidir. Cuando no coinciden, el agente puede listar la skill y no encontrarla al activarla, que es el tipo de fallo que no deja ningún mensaje de error.
Términos relacionados
Seguir por aquí
Fuentes
- Agent Skills — Anthropic. Comprobado el .
- Skills — Claude Code — Anthropic. Comprobado el .
- anthropics/skills — Anthropic. Comprobado el .