Claude Skills de 0 a 100: qué son y cómo crear la tuya

Le explicas a Claude tu forma de redactar un informe. Funciona genial. Mañana abres otro chat y tienes que explicárselo otra vez. Y al día siguiente, igual. Ese bucle es exactamente lo que las skills vienen a romper: empaquetas un proceso una vez y Claude lo usa cuando toca, sin que tú vuelvas a explicarlo.

Esta guía va de cero a tener tu primera skill funcionando: qué es, cómo Claude decide usarla, cómo crear la tuya paso a paso y los errores que la dejan muerta antes de empezar.

Qué es una skill (y qué no)

Una skill es una carpeta con un fichero llamado SKILL.md dentro. Ese fichero contiene instrucciones en lenguaje natural para una tarea concreta: cómo escribes tus emails, cómo montas un informe, qué reglas sigues al revisar código. Opcionalmente puede llevar más cosas —plantillas, documentos de referencia, scripts— pero el corazón siempre es el SKILL.md.

La diferencia con lo que ya conoces:

• Un prompt lo pegas tú cada vez. Trabajo manual, repetido.
• Un CLAUDE.md es contexto fijo de un proyecto: se lee al arrancar la sesión en esa carpeta.
• Una skill es modular y por tema. Claude tiene varias y elige la que aplica según lo que le pides. Sirve en cualquier proyecto, no en uno solo.

Si tienes un proceso que repites en sitios distintos, eso es una skill.

Cómo lee Claude las skills: los tres niveles

Aquí está la clave técnica que explica todo lo demás. Claude no carga tus skills enteras de golpe —eso gastaría contexto sin sentido—. Las lee en tres niveles, lo que se llama progressive disclosure:

1. Frontmatter (siempre cargado). Solo el name y la description de cada skill. Es la "etiqueta" que Claude tiene siempre a la vista para saber qué hay disponible.
2. SKILL.md completo (se carga si aplica). Cuando tu petición encaja con la description, Claude abre el cuerpo del fichero y lee las instrucciones.
3. Ficheros extra (bajo demanda). Carpetas como references/, scripts/ o assets/ solo se tocan si la tarea las necesita.

La consecuencia práctica es enorme: todo el peso de que tu skill se active o no recae en la description, porque es lo único que Claude ve antes de decidir. Si la description no le dice claramente cuándo usarla, ni se molesta en abrir el resto.

El frontmatter: name y description

El frontmatter son las dos líneas que van al principio del SKILL.md, entre ---. Mínimas pero decisivas.

name — el identificador, en kebab-case (minúsculas y guiones). Reglas que no se saltan:

• Minúsculas, palabras separadas por guiones: revisor-de-emails, no Revisor_Emails.
• Sin la palabra "claude" ni "anthropic" dentro.
• Sin etiquetas ni caracteres raros.

description — la frase que decide tu vida. Tiene que decir dos cosas: QUÉ hace la skill y CUÁNDO usarla, con frases que se parezcan a cómo tú pides las cosas. Tienes hasta unos 1024 caracteres; no los desperdicies en marketing, gástalos en disparadores concretos.

# ❌ FLOJA — Claude no sabe cuándo activarla
---
name: emails
description: Ayuda con los correos electrónicos.
---

# ✅ BUENA — dice QUÉ + CUÁNDO con disparadores reales
---
name: revisor-de-emails-blackdark
description: >
Revisa y reescribe emails con la voz de Blackdark: directo, sin relleno,
con asunto claro y una sola llamada a la acción. Úsala cuando el usuario
pida "revisa este email", "mejora este correo", "reescribe este mensaje
para que suene mejor" o pegue un borrador de email para enviar.
---

Fíjate en la versión buena: incluye las frases literales con las que pedirías la tarea ("revisa este email", "mejora este correo"). Eso es lo que engancha. Una description vaga es la causa número uno de que una skill no salte nunca.

Crea tu primera skill, paso a paso

Vamos a montar una skill de verdad. Dos caminos.

Camino A — que te la genere Claude. Le describes el caso en lenguaje natural ("quiero una skill que revise mis emails con tono directo, asunto claro y una sola CTA") y él te escribe el SKILL.md. Rápido para empezar; luego afinas la description a mano.

Camino B — a mano. Es más control y entiendes mejor qué pasa. Estructura recomendada del cuerpo:

---
name: revisor-de-emails-blackdark
description: >
Revisa y reescribe emails con la voz de Blackdark: directo, sin relleno,
asunto claro y una sola llamada a la acción. Úsala cuando el usuario pida
"revisa este email", "mejora este correo" o pegue un borrador para enviar.
---

# Revisor de emails Blackdark

## Instrucciones
- Tono directo y práctico. Fuera relleno, fuera "espero que estés bien".
- Asunto claro de menos de 50 caracteres.
- Una sola llamada a la acción, al final, inequívoca.
- Respeta el idioma del borrador original.

## Pasos
1. Lee el borrador y detecta el objetivo real del email.
2. Reescribe: asunto + cuerpo, máximo 120 palabras salvo que pidan más.
3. Marca en una línea aparte qué cambiaste y por qué.

## Ejemplo
Entrada: "Hola, quería ver si igual podríamos quizás agendar una llamada
cuando puedas para hablar del proyecto, gracias."
Salida:
Asunto: Llamada de 20 min esta semana
Cuerpo: ¿Te va bien una llamada de 20 min el jueves a las 11:00 para cerrar
el proyecto? Si no, dime dos huecos y me adapto.

## Errores a evitar
- No inventes datos que no estén en el borrador.
- No añadas más de una CTA aunque el original tenga varias intenciones.

Ahora colócala donde Claude la lea:

• En Claude Code: crea la carpeta ~/.claude/skills/revisor-de-emails-blackdark/ y mete dentro el SKILL.md. Reinicia la sesión y listo.
• En claude.ai: comprime la carpeta en un .zip y súbela desde el panel de skills; luego actívala con su interruptor.

El nombre de la carpeta y el name del frontmatter deben coincidir, y el fichero debe llamarse exactamente SKILL.md, en mayúsculas.

Cómo probarla (en dos frentes)

No des una skill por buena hasta probar las dos cosas que pueden fallar por separado:

1. ¿Se activa sola? Pídele la tarea con tus palabras reales —no copiando la description— y mira si Claude la usa sin que se lo digas. Prueba tres o cuatro variantes de cómo lo pedirías de verdad. Si no salta, el problema está en la description.
2. ¿El resultado es correcto? Una vez activada, comprueba que el output respeta las reglas (formato, tono, límites). Si se activa pero ignora instrucciones, suele ser que lo importante está enterrado al final o escrito de forma ambigua.

Errores comunes (y cómo arreglarlos)

Los fallos casi siempre son los mismos cinco:

• No se activa nunca → description vaga, sin "cuándo". Reescríbela con frases disparador concretas, las que tú usarías al pedir la tarea.
• Se activa de más, metiéndose donde no la llaman → description demasiado amplia. Acota el dominio y di explícitamente qué casos NO cubre.
• No la reconoce al subirla → el fichero no se llama SKILL.md exacto, o el name no está en kebab-case, o no coincide con la carpeta.
• Se activa pero no sigue las reglas → lo crítico está enterrado. Sube las reglas importantes arriba del todo y dales formato claro (listas, negritas).
• Va lenta o gasta mucho → el SKILL.md es un tocho. Deja en él lo esencial y mueve el detalle largo a ficheros de references/ que se carguen solo cuando hagan falta.

Una skill bien hecha es corta en el SKILL.md, brutal en la description y honesta sobre cuándo NO usarse. Empieza por una sola, la del proceso que más repites, y aféinala hasta que se dispare sola. Cuando veas a Claude hacer tu tarea sin que se lo expliques, ya lo has pillado.