# ¿Qué hace el campo description de una skill?

> El campo description del frontmatter es el texto con el que el agente decide si una skill sirve para la petición que acaba de recibir. Está en el contexto de forma permanente, y es lo único que el agente conoce de la skill antes de abrirla.

Fuente: https://skillsagentes.com/glosario/campo-description
Markdown: https://skillsagentes.com/glosario/campo-description.md

Área: Anatomía de una skill. Publicado el 2026-09-14. Última revisión: 2026-09-14. También: description, Descripción de la skill.

---

El campo description del frontmatter es el texto con el que el agente decide si una skill sirve para la petición que acaba de recibir. Está en el contexto de forma permanente, y es lo único que el agente conoce de la skill antes de abrirla.

## En corto

- No se escribe para una persona: se escribe para el agente que tiene que reconocer la tarea.
- Debe nombrar la tarea y sus disparadores, con las palabras que usa quien pide esa tarea.
- Una descripción vaga produce dos fallos opuestos: la skill no se activa cuando toca, o se activa cuando no toca.

## Cómo se escribe una descripción que se activa

La forma que funciona nombra la acción y añade una frase de «úsalo cuando…» con los términos que aparecerán en la petición real. Si la skill audita indexación, la descripción debe contener las palabras indexación, rastreo y las demás por las que un usuario pediría eso, no una presentación del archivo.

El otro lado del equilibrio es el alcance. Una descripción que promete demasiado se activa en tareas para las que no sirve y gasta el cuerpo entero para nada. Una tarea por skill es la regla que evita ese problema de raíz.

## Términos relacionados

- [Frontmatter](https://skillsagentes.com/glosario/frontmatter.md) — ¿Qué es el frontmatter de un SKILL.md?
- [SKILL.md](https://skillsagentes.com/glosario/skill-md.md) — ¿Qué es un archivo SKILL.md?
- [Carga progresiva](https://skillsagentes.com/glosario/carga-progresiva.md) — ¿Qué es la carga progresiva en una skill?
- [Token](https://skillsagentes.com/glosario/token.md) — ¿Qué es un token en un modelo de IA?

## Seguir por aquí

- [Cómo crear tu propia skill](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.
- [Equipping agents for the real world with Agent Skills](https://www.anthropic.com/engineering/equipping-agents-for-the-real-world-with-agent-skills) — Anthropic Engineering. 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)