Cómo escribir una descripción que active tu skill
Si una skill no se activa cuando debería, casi siempre el problema está en la descripción. Es la línea que Claude lee para decidir si tu skill encaja con lo que se le pide. Domínala y tus skills funcionarán a la primera.
Por qué la descripción lo es casi todo
Claude no lee el contenido completo de todas tus skills en cada mensaje: sería demasiado. Lo que hace es leer el nombre y la descripción de cada una y, con eso, decidir cuál usar. Por eso la descripción no es un resumen bonito: es el disparador. Si es vaga, tu skill se quedará dormida aunque sea perfecta por dentro.
La fórmula de una buena descripción
Una descripción que funciona suele tener tres ingredientes:
- El momento de activación: empieza por «Usa esta skill cuando…». Deja claro en qué situaciones debe entrar.
- La tarea concreta: incluye el verbo de acción (redactar, analizar, revisar, resumir, traducir…).
- El detalle que la distingue: el tema, el idioma, el formato o el tipo de documento. Esto evita que se active cuando no toca.
Ejemplos: de floja a excelente
❌ Floja
description: Ayuda con correos.
Demasiado corta y ambigua. ¿Ayuda a leerlos, a escribirlos, a traducirlos? Claude no sabrá cuándo usarla.
⚠️ Mejorable
description: Redacta correos profesionales.
Ya menciona la tarea, pero le falta el momento de activación y el contexto.
✅ Excelente
description: Usa esta skill cuando el usuario pida redactar, revisar o mejorar correos electrónicos profesionales en español: peticiones, reclamaciones, seguimientos o respuestas formales.
Tiene el momento («cuando el usuario pida»), la tarea («redactar, revisar, mejorar»), el contexto («correos profesionales en español») y ejemplos de casos. Se activará justo cuando toca.
Errores habituales que debes evitar
- Ser demasiado genérico: «ayuda con textos» se solapa con casi todo.
- Ser demasiado estrecho: si solo mencionas «facturas», no se activará con «recibos» o «presupuestos».
- Describir cómo en vez de cuándo: la descripción es para el disparador; el «cómo» va en las instrucciones.
- Repetir el nombre: si la skill se llama
traductor, no basta con «traduce cosas»; añade idiomas y contexto.
Compruébalo en tiempo real
El creador de SkillCreator incluye un medidor de calidad exclusivo: mientras escribes tu descripción, la puntúa de 0 a 100 y te dice exactamente qué le falta (el momento, la tarea o el detalle). Es la forma más rápida de acertar sin ser experto.