¿Qué es el frontmatter de un SKILL.md?
El frontmatter es el bloque YAML del principio de un SKILL.md, delimitado por tres guiones arriba y abajo. Declara los metadatos de la skill: como mínimo su nombre y su descripción, y opcionalmente las herramientas que puede usar.
- Última revisión
También: Front matter · Cabecera YAML
En corto
- Va en la primera línea del archivo: si hay algo antes de los tres guiones, deja de ser frontmatter.
- `name` y `description` son obligatorios; el resto de campos depende del agente.
- Es la parte que el agente lee siempre, así que es la parte que decide si la skill se activa.
Los campos
`name` identifica la skill y debe coincidir con el nombre de su carpeta. `description` explica qué hace y cuándo usarla. Algunos agentes admiten además una lista de herramientas permitidas, y los repositorios que publican packs suelen añadir campos propios que el agente ignora sin fallar.
El YAML es estricto con las comillas y la indentación. Una descripción de varias líneas se escribe con `>-` y el texto indentado debajo; escribirla en varias líneas sin ese marcador es el error de sintaxis más frecuente en una skill que «no aparece».
Términos relacionados
Fuentes
- Agent Skills — Anthropic. Comprobado el .
- Skills — Claude Code — Anthropic. Comprobado el .