# ¿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.

Fuente: https://skillsagentes.com/glosario/frontmatter
Markdown: https://skillsagentes.com/glosario/frontmatter.md

Área: Anatomía de una skill. Publicado el 2026-09-14. Última revisión: 2026-09-14. También: Front matter, Cabecera YAML.

---

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.

## 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

- [SKILL.md](https://skillsagentes.com/glosario/skill-md.md) — ¿Qué es un archivo SKILL.md?
- [Campo description](https://skillsagentes.com/glosario/campo-description.md) — ¿Qué hace el campo description de una skill?
- [allowed-tools](https://skillsagentes.com/glosario/allowed-tools.md) — ¿Qué es allowed-tools en una skill?
- [Skill](https://skillsagentes.com/glosario/skill.md) — ¿Qué es una skill de agente?

## 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.

---

[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)