¿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.
- Última revisión
También: description · Descripción de la skill
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
Seguir por aquí
Fuentes
- Agent Skills — Anthropic. Comprobado el .
- Equipping agents for the real world with Agent Skills — Anthropic Engineering. Comprobado el .