Cómo crear un skill de Claude: guía de SKILL.md (2026)

Un skill de Claude es una carpeta con un único archivo obligatorio, SKILL.md: una cabecera corta que dice qué hace el skill y cuándo usarlo, seguida de instrucciones en lenguaje normal. Así es cómo crear un skill de Claude en Claude Code: crea una carpeta dentro de ~/.claude/skills/, escribe un SKILL.md con un name y una description, y luego pide la tarea con tus palabras o escribe / seguido del nombre del skill. Abajo vas a construir un skill funcional para marketing, entender cómo decide Claude cuándo cargarlo e instalar skills hechos por otras personas.

Qué es un skill de Claude, en palabras simples

Piensa en un skill como un procedimiento guardado que Claude saca del estante cuando el trabajo lo pide. En lugar de pegar las mismas instrucciones en cada chat, las escribes una vez en un archivo y Claude las abre solo cuando tu petición coincide.

Los skills usan el formato abierto Agent Skills, que Anthropic desarrolló y publicó como estándar. Una carpeta de skill es portátil: Claude Code, las apps de Claude y la API de Claude la aceptan. Esta guía se centra en Claude Code, donde los skills son archivos normales.

Si ya usabas Claude Code, debes saber que los comandos slash personalizados se unieron a los skills. Un archivo antiguo .claude/commands/review.md sigue funcionando, pero una carpeta de skill además puede guardar plantillas, ejemplos y scripts.

Para la primera y la tercera tarjeta, mira qué poner en un archivo CLAUDE.md y qué es un servidor MCP.

Cómo se cargan los skills y por qué la descripción es lo más importante

La introducción a Agent Skills de Anthropic describe un sistema de carga en tres niveles que llama divulgación progresiva. Un token, en estas cifras, es el pequeño trozo de texto que cuentan los modelos de IA, a menudo una palabra corta o parte de una más larga.

Primera lección: la descripción es el disparador. Si no contiene las palabras que usas de forma natural al pedir la tarea, Claude no recurrirá al skill.

Segunda lección: cada skill instalado consume un poco de atención en cada turno, así que unos pocos skills bien usados valen más que una lista larga que olvidaste.

Dónde viven los skills

El signo ~ significa tu carpeta de usuario: /Users/tunombre en Mac y C:\Users\tunombre en Windows. Si un skill personal y uno de proyecto tienen el mismo nombre, gana el personal.

Crea un skill de brief de campaña, paso a paso

El ejemplo es un skill para alguien de marketing que escribe un brief de campaña cada semana. Primero reúne los datos que faltan, escribe el brief con una estructura fija y revisa su propio trabajo antes de entregarlo.

Paso 1: Escribe el procedimiento que ya sigues

Paso 2: Crea la carpeta del skill

Lo más fácil es pedírselo a Claude Code:

Crea una carpeta de skill personal llamada campaign-brief en mi directorio de skills (~/.claude/skills/) con un archivo SKILL.md vacío dentro.

Si prefieres escribirlo tú, usa Terminal en Mac:

$ mkdir -p ~/.claude/skills/campaign-brief
$ 

O PowerShell en Windows:

PS> New-Item -ItemType Directory -Force -Path "$HOME\.claude\skills\campaign-brief"
PS> 

Paso 3: Escribe SKILL.md

Crea SKILL.md dentro de la carpeta y pega esto. La parte entre las dos líneas --- es el frontmatter, un pequeño bloque de ajustes escrito en YAML (un formato sencillo de "clave: valor"), y todo lo que viene después son las instrucciones.

---
name: campaign-brief
description: Escribe un brief de campaña de marketing de una página a partir de notas sueltas. Úsalo cuando el usuario pida un brief de campaña, un brief creativo o un plan para un lanzamiento, una promoción o una campaña de email.
---

# Brief de campaña

## Antes de escribir
Comprueba que tienes estos datos. Pide lo que falte en una lista corta y espera:
- Producto u oferta, y su precio si lo tiene
- Público: quiénes son y qué problema tienen
- Objetivo: un resultado medible, como reservas de demo o primeras compras
- Canales y fecha límite
- Presupuesto, o "ninguno"

## Escribe el brief
Usa exactamente estas secciones, en este orden:
1. Resumen (tres frases como máximo)
2. Público y su principal objeción
3. Mensaje clave y tres puntos de apoyo
4. Oferta y llamada a la acción
5. Canales, con una línea sobre la función de cada uno
6. Calendario con fechas
7. Cómo mediremos el éxito
8. Preguntas abiertas

Si existe brand/voice.md en este proyecto, léelo primero y síguelo.
Guarda el brief como briefs/AAAA-MM-DD-nombre-campana.md.

## Reglas
- Nunca inventes cifras, precios, fechas ni testimonios. Escribe [PENDIENTE] en su lugar.
- Que ocupe una página, unas 450 palabras.
- Usa las palabras que usaría el público, no jerga de marketing.

## Antes de terminar
Relee el brief y confirma que cada sección está completa o marcada como [PENDIENTE], que el objetivo se puede medir y que la llamada a la acción corresponde a la oferta. Enumera cada [PENDIENTE] al final.

Paso 4: Añade un archivo de apoyo

Pega un brief del que estés orgulloso en examples.md dentro de la misma carpeta y añade una línea bajo "Escribe el brief": "Para el tono y la profundidad, mira examples.md." Claude lee el ejemplo solo cuando ejecuta el skill, así que el resto del tiempo no cuesta nada.

campaign-brief/
  SKILL.md
  examples.md

Paso 5: Pruébalo de dos maneras

Abre Claude Code en cualquier carpeta de proyecto. Si ya estaba abierto y la carpeta de skills es nueva, ejecuta primero /reload-skills.

Primero, la prueba automática: pide la tarea con palabras normales y observa cómo Claude toma el skill.

Luego, la prueba directa: escribe /campaign-brief email de rebajas de fin de año, y el texto después del nombre del skill se pasa como argumentos. Para confirmar que Claude ve el skill, pregunta "¿Qué skills tienes disponibles?" o ejecuta /skills.

Paso 6: Ajústalo

Cuenta con varias rondas de cambios. Claude Code detecta los cambios en los archivos de un skill durante la sesión, así que edita, guarda y vuelve a probar.

• Nunca se activa: añade a la descripción las palabras que de verdad usas.
• Se activa cuando no quieres: acota la descripción o añade disable-model-invocation: true para que el skill solo se ejecute cuando escribas su comando.
• Olvida una regla al final de una sesión larga: sube esa regla al principio. Cuando una conversación larga se compacta, Claude Code conserva solo el inicio de cada skill que vuelve a adjuntar.

Ajustes opcionales que conviene conocer

Ignóralos hasta que tu primer skill funcione.

Dentro de las instrucciones, $ARGUMENTS marca dónde va el texto que escribes después del comando.

Usa el mismo skill en la app de Claude

Los skills también funcionan en las apps web y de escritorio de Claude, con la configuración que describe el artículo de ayuda de Anthropic sobre skills:

1. Activa la ejecución de código. En los planes Free, Pro y Max, abre Settings > Capabilities y activa Code execution and file creation. En Team y Enterprise lo activa un propietario para toda la organización.
2. Comprime la carpeta. La carpeta debe estar en el nivel superior del zip: campaign-brief.zip contiene campaign-brief/SKILL.md.
3. Súbela. Abre Customize > Skills, haz clic en +, elige Create skill y luego Upload a skill.
4. Actívala y prueba. Usa algunos prompts que deberían activarla.

El Centro de ayuda indica un límite de 200 caracteres para la descripción en claude.ai, otro motivo para que sea breve. El ejemplo de arriba cabe.

Instala skills hechos por otras personas

No tienes que escribir cada skill tú:

El repositorio público de skills de Anthropic (mira los que probamos en nuestro directorio de skills) también funciona como marketplace. Estos dos comandos lo añaden e instalan sus skills de ejemplo, que incluyen guías de marca, coautoría de documentos y skills de diseño como Canvas Design:

/plugin marketplace add anthropics/skills
/plugin install example-skills@anthropic-agent-skills

Después Claude Code te pide un alcance: solo para ti, para todo el proyecto o solo para ti en este proyecto.

Revisa un skill antes de confiar en él

Un skill puede decirle a Claude que ejecute comandos y lea archivos, así que instalarlo es como instalar software. La documentación de Anthropic recomienda usar skills solo de fuentes de confianza, es decir, los que escribiste tú o los de Anthropic, y auditar a fondo cualquier otro.

Solución de problemas

Qué hacer ahora

Elige una tarea que le hayas explicado a Claude más de dos veces este mes y conviértela hoy en un skill, usando el brief de campaña como plantilla. Pruébala con tres formas distintas de pedirla antes de confiar en ella.

Para ideas que vale la pena empaquetar, los flujos de Claude Code para marketing se convierten bien en skills, y el directorio de Claude Skills muestra lo que otros han creado. Si quieres configurar skills, MCP y CLAUDE.md juntos con una guía, el curso de Claude Code cubre los tres en su módulo de configuración.