Disparadores de skills que sí se activan
Construiste un skill. Está bien escrito, hace exactamente lo que querías cuando lo probaste — y luego Claude simplemente nunca vuelve a usarlo. El skill no está roto. Su descripción sí.
Claude nunca lee el archivo completo para decidir
Esta es la parte que la mayoría entiende mal sobre cómo funcionan los skills: cuando Claude decide si un skill es relevante para la conversación actual, no lee el SKILL.md completo. Lee el nombre y la descripción corta. Solo a partir de esa descripción decide si carga y dispara el skill.
Eso significa que la descripción no es documentación — es toda la interfaz que Claude usa para enrutar trabajo hacia tu skill. Si la descripción no coincide claramente con la situación para la que construiste el skill, este queda ahí sin usarse por más buenas que sean las instrucciones que lleva dentro.
Las descripciones vagas casi nunca se disparan
Una descripción como "edita publicaciones" se lee bien para una persona que hojea una lista de skills. Para la decisión de enrutamiento que Claude toma en cada turno, es casi inútil — no distingue este skill de otras diez cosas que vagamente podrían llamarse "editar", y no da ninguna señal sobre cuándo recurrir a él.
Compáralo con una descripción construida alrededor de una condición de disparo explícita:
"Usar cuando Peter pega un borrador de publicación o boletín, o pide editar el título o darle más fuerza a un texto largo."
Esa versión nombra las situaciones exactas que deberían activar el skill: pegar un borrador, pedir editar un título, pedir darle más fuerza a un texto largo. No hay ambigüedad que Claude tenga que resolver — la descripción hace el trabajo de coincidencia directamente.
| Estilo de descripción | Comportamiento |
|---|---|
| Resumen genérico ("edita publicaciones") | Rara vez se dispara; Claude no sabe cuándo aplica |
| Disparador explícito "usar cuando X" | Se dispara de forma confiable; coincide con la situación exacta |
Cómo reescribir tus descripciones
- Abre cada skill que hayas construido y lee solo la línea de descripción — imagina que eres Claude sin ver nada más.
- Pregúntate qué situación debería dispararlo, específicamente. No "maneja tareas de escritura" sino "el usuario pega un borrador de boletín o pide darle más fuerza a un texto largo."
- Empieza con "usar cuando..." y termina la frase con la situación, acción o frase concreta que debería activarlo. Si puedes listar dos o tres escenarios reales, ponlos todos.
- Vuelve a probar en una conversación nueva. Provoca la situación que describiste y confirma que el skill de verdad se carga — no confíes solo en que la nueva redacción te suena mejor.
Un skill sin usar es un problema de disparo, no un mal skill
Este es el replanteo que vale la pena interiorizar: si un skill que construiste nunca se dispara, el instinto es asumir que el skill en sí está mal y empezar a reescribir las instrucciones. Normalmente las instrucciones están bien. La descripción es lo que está fallando, en silencio, porque no hay ningún mensaje de error cuando Claude decide no cargar un skill — simplemente no ocurre, y no tienes visibilidad de por qué.
El respaldo manual mientras ajustas la redacción
No tienes que dejar la descripción perfecta antes de poder usar el skill. Los skills se pueden disparar manualmente por nombre — puedes indicarle explícitamente a Claude que use un skill específico sin importar lo que diga su descripción. Eso te da una forma de seguir usando y refinando el comportamiento real de un skill mientras iteras la descripción por separado, sin que ambas preocupaciones se bloqueen entre sí.
Trucos de nivel avanzado
- Escribe la descripción primero, no al final. Trátala como la frase más importante del archivo, no como un resumen que despachas después del trabajo de verdad.
- Describe el disparo, no la capacidad. "Puede editar cualquier texto" le dice a Claude de qué es capaz el skill, no cuándo recurrir a él por encima de cualquier otra cosa.
- Fuerza el disparo por nombre mientras ajustas. Usa la invocación manual para seguir ejercitando el comportamiento real de un skill mientras iteras puramente sobre la redacción de su descripción.
Recursos
¿Construyendo una funcionalidad con IA? Yeda AI diseña, audita y lanza sistemas LLM en producción.