Una skill de Claude Code es una carpeta con un archivo de instrucciones dentro. Eso es todo. La creas en cinco minutos, y a partir de ahí Claude sabe hacer una tarea concreta de tu empresa exactamente como tú la harías.
Yo llevo la operación diaria de DigitalBrain con skills: una publica las noticias de la web, otra monta la newsletter, otra genera las facturas de los patrocinadores, otra prepara el montaje de las clases. Te cuento cómo se hace una, qué he aprendido escribiéndolas y en qué me equivoqué al principio.
Si aún no tienes claro qué son, empieza por qué son las Skills de Claude Code. Aquí vamos al cómo.
La estructura mínima
Una skill vive en `.claude/skills/nombre-de-tu-skill/` y necesita un solo archivo:
.claude/skills/
mi-skill/
SKILL.mdEl `SKILL.md` empieza con un bloque de metadatos y sigue con las instrucciones en texto normal:
---
name: mi-skill
description: Qué hace esta skill y cuándo debe usarse. Usa cuando el usuario diga /mi-skill, "haz X", "prepara Y".
---
# Instrucciones
Aquí escribes, en español y como se lo explicarías a alguien nuevo,
qué pasos hay que dar y en qué orden.Y ya está. Escribes `/mi-skill` en Claude Code y se ejecuta.
La `description` es lo más importante del archivo
Este es el error que cometí al principio y el que más veo repetido. La `description` no es un comentario para que quede bonito. Es lo único que Claude lee para decidir si esta skill toca o no toca.
Si escribes "skill de facturas", no se va a disparar cuando digas "genera la factura de agosto". Si escribes "Genera facturas PDF para sponsors. Usa cuando el usuario diga /db-factura, 'haz la factura de X', 'facturar a X'", se dispara siempre.
La regla práctica: mete en la description las palabras exactas que vas a decir tú. No las que suenan técnicas.
El reparto que hace que una skill funcione
Aquí está la parte que separa una skill que aguanta de una que se rompe cada semana.
Lo mecánico va en scripts. El criterio va en las instrucciones.
En mi skill de noticias lo tengo escrito literalmente al principio del archivo: yo, Claude, redacto; los scripts hacen lo mecánico. Los scripts sondean las fuentes, construyen el fichero de datos, publican en la web, asignan las imágenes. Lo que queda para el modelo es lo que necesita cabeza: decidir qué historia es noticia y cuál es ruido, escribirla, detectar que algo ya se publicó ayer.
Si le pides al modelo que haga la parte mecánica, cada ejecución sale un poco distinta y un día se te cuela un error. Si le pides que ejecute un script, sale igual siempre.
Escribe los errores dentro de la skill
La segunda cosa que aprendí: una skill madura no son solo pasos. Son pasos más los tropiezos que ya tuviste.
Mis skills tienen avisos escritos dentro del archivo, con la fecha del día en que la lie. Cosas del tipo "nunca ejecutes este comando sin este parámetro, porque el 29 de julio publicó de golpe cientos de entradas del histórico". Eso no es documentación, es una barandilla.
Cada vez que algo salga mal, vuelve al `SKILL.md` y escribe la regla. La skill mejora sola con el uso, pero solo si le devuelves lo aprendido.
Cómo se ve una skill de verdad por dentro
La de facturas de patrocinadores, por ejemplo, no tiene magia. Tiene el dato de dónde vive la información de cada patrocinador, el formato exacto que llevan mis facturas, la numeración que hay que respetar para que no se repita un número, y qué hacer con el PDF cuando está listo. Escrito en párrafos, como se lo explicaría a alguien que entra nuevo.
La de las noticias de la web es más larga porque el proceso lo es: sondear fuentes, comprobar que la historia no está publicada ya, escribirla, ponerle imagen, publicar. Y tiene una carpeta al lado con los textos largos que no quiero repetir dentro del archivo principal.
Esa es toda la anatomía. Un archivo de instrucciones, y si hace falta, carpetas con material de apoyo y scripts que la skill llama por su nombre.
Cómo montar la tuya en una tarde
1. Elige un proceso que ya hagas a mano y repitas. Da igual que sea pequeño. Cuanto más aburrido, mejor candidato. 2. Ejecútalo una vez con Claude Code, hablando. Sin skill, a pelo, diciéndole los pasos. 3. Cuando salga bien, pídele que escriba el SKILL.md de lo que acabáis de hacer. Es su propio manual, y lo escribe mejor que tú. 4. Revísalo y afina la `description` con las palabras que dirías tú. 5. Úsala unas cuantas veces y corrige. Cuando falle, la corrección va al archivo, no solo al chat.
El paso 3 es el truco. No te sientes a escribir la skill desde cero: haz el trabajo una vez y pide que lo documente.
Cuándo NO merece la pena
Si el proceso lo haces una vez cada seis meses, no hagas una skill. Se te va a olvidar que existe y va a estar desactualizada cuando la necesites.
Si el proceso cambia cada vez que lo haces, tampoco. Una skill fija una forma de trabajar, y fijar algo que todavía se está moviendo te va a dar más guerra que ayuda.
El punto dulce está en lo que haces cada semana, siempre igual, y te aburre.
Un apunte sobre el CLAUDE.md
La skill dice cómo se hace una tarea. El CLAUDE.md dice cómo es tu empresa: quién es quién, qué convenciones sigues, dónde están las credenciales. Los dos se leen juntos.
Si te encuentras repitiendo el mismo contexto en cinco skills distintas, ese contexto va al CLAUDE.md, no dentro de cada una.
En Digital Brain publicamos noticias de IA a diario y los miércoles una pieza de formación a fondo.
Relacionado
