Glosario de Claude Code
Descripción de habilidad
El campo de frontmatter `description` le indica a Claude Code cuándo aplicar una habilidad.
También llamado: skill trigger description, description frontmatter, when does a skill trigger
El campo de frontmatter description es lo que Claude usa para decidir cuándo aplicar una habilidad. Es la línea más importante en un archivo SKILL.md, porque es la única parte de la habilidad que siempre está en contexto. Si se omite description, Claude Code usa el primer párrafo del contenido markdown.
Pon el caso de uso clave PRIMERO. El texto combinado de description y when-to-use se trunca a 1.536 caracteres en el listado de habilidades para reducir el uso de contexto. Este límite es configurable con la configuración skillListingMaxDescChars. También hay un presupuesto de listado general para todas las habilidades, ajustable a través de la configuración skillListingBudgetFraction o la variable de entorno SLASH_COMMAND_TOOL_CHAR_BUDGET. Para liberar presupuesto, las entradas de baja prioridad pueden configurarse como 'solo nombre' en skillOverrides para que se listen sin descripción.
Una buena descripción dice lo que hace la habilidad Y cuándo usarla, en palabras del usuario en lugar de las del autor. El protocolo de prueba de SkillProof evalúa esto directamente: la etapa de activación escribe tres frases que DEBERÍAN activar la habilidad y dos adyacentes que NO deberían, luego juzga honestamente si la descripción ganaría la carga. Las descripciones vagas son la razón más común por la que una habilidad técnicamente buena nunca se activa. Por ejemplo, la descripción de la habilidad Skill Audit establece claramente su propósito: "Audita una base de código en busca de calidad, consistencia y patrones rotos antes del lanzamiento."