Cómo escribir la descripción de una skill de Claude
La descripción es lo más importante de una skill de Claude: decide cuándo se activa sola. Aquí qué debe responder y cómo llenarla de palabras clave para que dispare cuando la necesitas.
Por Humberto Luciano · experto en marketing digital con IA
La descripción es lo más importante de una skill de Claude porque decide cuándo se activa sola. Tiene que responder dos preguntas: qué hace la skill y con qué palabras debe dispararse. Si esas dos no quedan claras, la skill se queda dormida aunque su contenido sea perfecto.
La descripción es el interruptor de toda la skill.
Puntos clave
- La descripción decide cuándo se activa la skill, no solo qué dice de ella.
- Debe responder dos preguntas: qué hace la skill y cuándo se dispara.
- Las skills se activan con palabras clave que tú pones en la descripción.
- Si no dispara cuando la necesitas, la solución casi siempre es agregar más palabras clave.
- Escribe los disparadores como tú pides la tarea, no como lo diría un manual.
¿Qué debe responder la descripción?
Dos cosas: qué hace la skill y cuándo se activa.
Lo primero es la función. "Genera cotizaciones a partir de una transcripción de venta".
Lo segundo son los disparadores. "Usa esta skill cuando el usuario mencione cotización, propuesta comercial o presupuesto".
La primera mitad le dice a Claude para qué sirve. La segunda le dice con qué palabras tuyas debe encenderse.
La gente cuida mucho el contenido de la skill y descuida la descripción. Es al revés de como debería ser.
Una skill brillante con una descripción floja casi nunca dispara. Y una que nunca dispara es como no tenerla.
¿Por qué la descripción decide si la skill se activa?
Porque las skills se activan solas, sin que tú las invoques a mano.
Claude lee la descripción de cada skill disponible. Cuando le pides algo, decide cuál corresponde a esa tarea.
Si tu descripción dice claro qué hace y con qué palabras dispara, Claude la enciende en el momento justo. Si es vaga, la pasa por alto.
Piensa la descripción como una lista de señales. Cada palabra clave es una bandera que le avisa a Claude: "si el usuario escribe esto, te toca a ti".
Esto importa más conforme tienes varias skills. La descripción es lo que evita que se confundan entre ellas.
¿Cómo escribo buenas palabras clave?
Escríbelas como tú pides la tarea en la vida real. No como lo pondría un diccionario.
Si cuando necesitas cotizar a veces dices "cotización", a veces "propuesta" y a veces "presupuesto", mete las tres.
Cada variante con la que tú arrancas la tarea debe estar en la descripción.
| Si tu skill hace... | Palabras clave que conviene meter |
|---|---|
| Cotizaciones | cotización, propuesta comercial, presupuesto, cotizar |
| Reportes | reporte, informe, resumen de resultados, dame el reporte |
| Research de audiencia | research, investigar audiencia, buyer persona, objeciones |
| Limpiar copy | pulir copy, revisar texto, que no suene a IA |
La idea es cubrir cómo hablas tú. Si trabajas en equipo, mete también cómo lo piden ellos.
¿Qué hago si la skill no dispara cuando la necesito?
Agrega más palabras clave a la descripción.
Casi siempre el problema es el mismo: pediste la tarea con una palabra que la descripción no contemplaba.
Abre la skill. Mira con qué la llamaste. Suma esa variante a los disparadores.
Es un arreglo de un minuto.
Esto es parte de tratar la skill como algo vivo: la usas, ves dónde falla y la ajustas. El ciclo completo de mejora lo cuento en cómo actualizar e iterar tus skills.
¿Todavía no tienes la skill creada? El método para armarla está en cómo crear una skill paso a paso.
Preguntas frecuentes
- ¿Qué debe responder la descripción de una skill?
- Dos cosas: qué hace la skill y cuándo se activa. Lo primero le dice a Claude para qué sirve; lo segundo, con qué palabras del usuario debe dispararse. Si la descripción no deja claras esas dos, la skill no se activa cuando la necesitas.
- ¿Por qué la descripción es lo más importante de la skill?
- Porque las skills se activan solas. Claude lee la descripción y decide si esta tarea le toca. Si la descripción es vaga, la skill se queda dormida aunque el contenido adentro sea perfecto. La descripción es el interruptor.
- ¿Qué hago si la skill no se activa cuando la necesito?
- Agrega más palabras clave a la descripción. Piensa cómo escribes tú cuando pides esa tarea: cotización, propuesta comercial, presupuesto. Mete esas variantes. Cada palabra que sueles usar es un disparador más.
- ¿Tengo que escribir la descripción a mano?
- Claude la propone cuando crea la skill, pero tú la afinas. Es la parte que más conviene revisar porque decide cuándo dispara. Léela y pregúntate: con esto, ¿se activaría cuando yo lo pida? Si dudas, agrega palabras clave.