when_to_use

when_to_use es un campo opcional de frontmatter de SKILL.md que contiene contexto adicional sobre cuándo Claude debe invocar la habilidad: frases desencadenantes o solicitudes de ejemplo.

Mecánicamente, se añade al campo description en la lista de habilidades. Este texto combinado cuenta para el mismo límite de 1.536 caracteres en el que se trunca el texto de description y when_to_use. Por lo tanto, no es espacio extra gratuito; es el mismo presupuesto, gastado de manera diferente.

Utiliza when_to_use cuando la forma natural de describir lo que hace una habilidad y la forma natural en que un usuario la solicitaría son frases diferentes. La description lleva el 'qué', y when_to_use lleva las frases específicas que un usuario podría emplear. Dado que ambos campos se truncan juntos, debes priorizar poner el caso de uso clave primero en tu description en lugar de depender de when_to_use para rescatar una explicación principal vaga.

Ten en cuenta que la ortografía con guion bajo es correcta aquí (when_to_use). Esto difiere de los campos con guiones como argument-hint y allowed-tools. Esta inconsistencia es real y vale la pena verificarla dos veces cuando escribes frontmatter manualmente. Por ejemplo, la habilidad Skill Audit utiliza when_to_use para aclarar cómo los usuarios podrían solicitar una revisión de código, separada de su descripción principal.

Este campo es distinto del concepto general de model-invocation, que se refiere al proceso más amplio de cómo Claude decide usar cualquier herramienta o habilidad basándose en el prompt y el contexto disponible. when_to_use proporciona orientación específica para ese proceso de invocación para una habilidad particular.