# ¿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. Fuente: https://skillsagentes.com/glosario/skill-md Markdown: https://skillsagentes.com/glosario/skill-md.md Área: Fundamentos. Publicado el 2026-09-14. Última revisión: 2026-09-14. También: skill.md, Archivo de skill. --- 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. ## 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 - [Skill](https://skillsagentes.com/glosario/skill.md) — ¿Qué es una skill de agente? - [Frontmatter](https://skillsagentes.com/glosario/frontmatter.md) — ¿Qué es el frontmatter de un SKILL.md? - [Campo description](https://skillsagentes.com/glosario/campo-description.md) — ¿Qué hace el campo description de una skill? - [references/](https://skillsagentes.com/glosario/carpeta-references.md) — ¿Qué es la carpeta references de una skill? ## Seguir por aquí - [Qué son las Claude Skills, con un SKILL.md de ejemplo](https://skillsagentes.com/claude-skills.md) ## Fuentes - [Agent Skills](https://docs.claude.com/en/docs/agents-and-tools/agent-skills) — Anthropic. Comprobado el 2026-09-14. - [Skills — Claude Code](https://docs.claude.com/en/docs/claude-code/skills) — Anthropic. Comprobado el 2026-09-14. - [anthropics/skills](https://github.com/anthropics/skills) — Anthropic. Comprobado el 2026-09-14. --- [Glosario completo](https://skillsagentes.com/glosario.md) · [Guía de Claude Skills](https://skillsagentes.com/claude-skills.md) · [Todas las skills](https://skillsagentes.com/skills.md) Skills Agentes · [Índice de páginas en markdown](https://skillsagentes.com/sitemap.md) · [Inicio](https://skillsagentes.com/index.md)