01 Qué es una skill y en qué se diferencia de un prompt
Una skill es una carpeta con un archivo SKILL.md: una cabecera con el nombre y la descripción, y debajo las instrucciones que Claude sigue. Puede incluir archivos de apoyo como plantillas, ejemplos o scripts. Claude solo lee la descripción de todas tus skills; cuando una petición encaja con alguna, carga sus instrucciones completas. Por eso puedes tener muchas sin saturar el contexto.
| Herramienta | Para qué sirve | Cuándo se aplica |
|---|---|---|
| Prompt suelto | Una petición puntual | Solo en ese mensaje |
| Instrucciones de proyecto o CLAUDE.md | Contexto fijo de un proyecto | Siempre, en ese proyecto |
| Skill | Un proceso repetible de A a B | Cuando la petición coincide con su descripción, o cuando la invocas con /nombre |
02 Paso 1: usa la guía oficial como material para Claude
Anthropic publica una guía extensa sobre cómo construir skills y mantiene la documentación de Skills en su web de documentación. No hace falta que la estudies: descárgala o copia su contenido, dásela a Claude y pídele que la aplique a tu caso. Lo que importa es que Claude conozca las reglas (descripciones precisas, instrucciones por pasos, archivos de apoyo) y tú aportes el conocimiento de tu negocio.
Te adjunto la guía oficial de Anthropic sobre cómo construir skills. Úsala como referencia para todo lo que hagamos hoy, pero no me la resumas.
Quiero identificar las tres skills que más tiempo me ahorrarían. Hazme preguntas de una en una sobre:
- Qué documentos o mensajes redacto cada semana.
- Qué procesos repito siguiendo los mismos pasos.
- Qué le explico a Claude una y otra vez.
Con mis respuestas, propón tres skills. Para cada una: nombre en kebab-case, qué hace, la descripción exacta que usarías para que se active, qué archivos de apoyo necesitaría y una frase de ejemplo con la que yo la dispararía.
03 Paso 2: una skill para documentos con tu formato
Es la más fácil de rentabilizar: informes mensuales, propuestas comerciales, actas de reunión, presupuestos. Hoy repites la estructura y el tono cada vez; con una skill lo haces una vez. La clave es darle ejemplos reales, porque el estilo se copia de lo que ve, no de lo que describes.
Crea una skill para redactar mis [INFORMES / PROPUESTAS / ACTAS] siempre con la misma estructura y el mismo tono.
Antes de escribirla, pregúntame: secciones y orden, extensión, tono, destinatario habitual, datos que nunca deben faltar y errores que no quiero ver. Después te pasaré dos documentos reales de referencia.
Guarda la estructura como plantilla en un archivo aparte dentro de la skill y los ejemplos en una carpeta de referencia. En el SKILL.md deja instrucciones por pasos: pedir los datos que falten, rellenar la plantilla, revisar contra la lista de comprobación y entregar.
Al terminar, enséñame el SKILL.md completo y cinco frases con las que debería activarse.
04 Paso 3: una skill para un proceso de varios pasos con plan B
Cuando el trabajo tiene un orden fijo, la skill debe impedir saltarse pasos y saber qué hacer cuando algo falla. Un ejemplo típico en una agencia: dar de alta a un cliente nuevo (crear la ficha, generar el enlace de pago, enviar la bienvenida al confirmarse el cobro). Así puede quedar el núcleo de esa skill:
---
name: alta-cliente
description: Da de alta a un cliente nuevo de la agencia (ficha en el CRM, enlace de pago y correo de bienvenida). Úsala cuando pida «alta de cliente», «nuevo cliente» o «onboarding de cliente».
---
# Alta de cliente
## Pasos (en este orden, sin saltar ninguno)
1. Pide nombre fiscal, CIF, contacto, servicio contratado e importe.
2. Crea la ficha en el CRM con esos datos y confirma el identificador.
3. Genera el enlace de pago por el importe acordado.
4. Cuando el pago figure como cobrado, envía la bienvenida usando plantillas/bienvenida.md.
## Si algo falla
- Si el enlace de pago no se genera: prepara los datos para un cobro manual y avísame.
- Si el pago no aparece en 48 horas: redacta un recordatorio amable en lugar de la bienvenida.
- Si ocurre algo que no está en esta lista: detente y explícame qué ha pasado. No improvises.
Crea una skill para este proceso que repito a menudo: [DESCRÍBELO PASO A PASO, CON LAS HERRAMIENTAS QUE USAS EN CADA UNO].
Requisitos:
- Los pasos se ejecutan siempre en orden y no se pasa al siguiente sin completar el anterior.
- Si un paso necesita un dato o un acceso que solo tengo yo, me lo pide; nunca lo inventa.
- Añade una sección «Si algo falla» con estas situaciones y su alternativa: [LISTA LO QUE SUELE FALLAR Y QUÉ HACER].
- Ante cualquier fallo que no esté en la lista, se detiene y me avisa.
Enséñame el SKILL.md antes de guardarlo.
05 Paso 4: deja que skill-creator haga el trabajo pesado
skill-creator es una skill oficial de Anthropic que crea, prueba y mejora otras skills. En los planes de pago de claude.ai las skills de ejemplo de Anthropic ya están disponibles. En Claude Code se instalan desde el repositorio oficial como plugin:
/plugin marketplace add anthropics/skills
/plugin install example-skills@anthropic-agent-skills
Usa la skill skill-creator. Quiero convertir esto en una skill: [ADJUNTA UN MANUAL, UNA PLANTILLA O UN PROCEDIMIENTO, O DESCRIBE EL PROCESO COMO SE LO EXPLICARÍAS A ALGUIEN EN SU PRIMER DÍA].
Pregúntame lo que falte antes de escribirla. Cuando esté lista, dime su nombre, qué hace, con qué frases se activa y qué casos de prueba has usado para comprobarla.
06 Probar que se activa y mantenerla
El fallo más habitual de una skill recién creada es la descripción: demasiado vaga y nunca se activa, demasiado amplia y salta cuando no toca. Pruébala antes de confiarle trabajo real.
Tengo instalada la skill [NOMBRE]. Te voy a escribir 6 peticiones: algunas deberían activarla y otras no. Para cada una, dime si se activaría y por qué, citando su descripción. Si hay fallos, propón la descripción corregida.
1. [PETICIÓN]
2. [PETICIÓN]
3. [PETICIÓN]
4. [PETICIÓN]
5. [PETICIÓN]
6. [PETICIÓN]
- ✓La descripción dice qué hace y cuándo usarla, con las palabras que tú usas al pedirlo.
- ✓Las instrucciones van por pasos numerados, no en párrafos largos.
- ✓Las plantillas y ejemplos largos están en archivos aparte, no dentro del SKILL.md.
- ✓Hay una sección clara de qué hacer si algo falla y cuándo detenerse.
- ✓Si la skill es solo para lanzarla tú a mano, añade disable-model-invocation: true en la cabecera.
- ✓Revisa la skill cuando cambie tu proceso: una skill desactualizada repite errores con mucha seguridad.
Preguntas frecuentes
No. Una skill es texto en Markdown y Claude la redacta contigo. Solo necesitas saber explicar bien tu proceso y aportar ejemplos reales.
El formato es el mismo. Si inicias sesión en Claude Code con tu cuenta de claude.ai, las skills activadas en tu cuenta se sincronizan; también puedes copiar la carpeta a ~/.claude/skills/.
Los comandos personalizados se han fusionado con las skills: un archivo en .claude/commands/ sigue funcionando, pero las skills permiten archivos de apoyo y que Claude las cargue automáticamente cuando encajan.
Revisa la descripción: debe incluir las palabras con las que pides la tarea. Usa el test de activación de esta guía o invócala directamente escribiendo /nombre-de-la-skill.
Sí. En Claude Code, guárdalas en .claude/skills/ dentro del repositorio y haz commit para que todo el equipo las tenga. Las empresas también pueden desplegar skills para todos los equipos mediante la configuración gestionada de Claude Code.
Sobre el autor
Equipo editorial de appyweb
Marketing, SEO y desarrollo con IA
Especialistas de appyweb en SEO, publicidad, desarrollo web y automatización con IA.