Cómo crear una skill de Claude: 6 pasos y un ejemplo (2026)

Los skills en un minuto

Un skill de Claude es una carpeta de instrucciones, un archivo SKILL.md más ejemplos y scripts opcionales, que Claude carga por su cuenta cuando tu petición coincide con la descripción del skill. Escribes un procedimiento una vez en lugar de pegarlo en cada chat, y un archivo antiguo de comando slash personalizado, como .claude/commands/review.md, sigue funcionando porque los comandos slash ahora también son skills.

Los skills usan el formato abierto Agent Skills, así que la misma carpeta funciona en Claude Code, las apps de Claude y la API de Claude. Para una respuesta más completa sobre qué son los skills de Claude, con skills listos para instalar, explora nuestro directorio de skills de Claude. Los skills son la lección 3 de nuestro curso Claude gratis, que también cubre Projects, conectores y tareas.

Claude skills vs MCP, plugins y CLAUDE.md

El Centro de ayuda de Anthropic explica la diferencia entre skills y MCP de forma sencilla: MCP le da a Claude acceso a una herramienta, y un skill le enseña a usarla bien, así que los dos funcionan mejor juntos. Para las otras tarjetas, 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: Claude decide si abre un skill solo a partir de su nombre y su descripción. Cuando varios skills o herramientas podrían hacer un trabajo, gana aquel cuya descripción usa tus palabras.

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 se guardan los skills de Claude

El signo ~ significa tu carpeta de usuario: /Users/yourname en Mac y C:\Users\yourname en Windows, así que un skill personal en Windows vive en C:\Users\yourname\.claude\skills\. La carpeta .claude está oculta por defecto: presiona Cmd + Shift + . en Finder, o activa Hidden items en View en el Explorador de archivos. Si un skill personal y uno de proyecto tienen el mismo nombre, gana el personal.

Cómo crear un skill de Claude, paso a paso

El ejemplo es uno de los skills de Claude para marketing más sencillos de construir: un redactor de briefs de campaña para alguien de marketing que escribe uno 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 el archivo 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 pidan un brief de campaña, un brief creativo o un plan de lanzamiento, promoción o 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.

A Claude Code le basta con la description; sin un name, el nombre de la carpeta se convierte en el comando. La app de Claude exige los dos, así que escribe ambos y el mismo archivo funciona en todas partes.

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. Anthropic sugiere mantener SKILL.md por debajo de 500 líneas y pasar el material de referencia largo a archivos como este.

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.

Hicimos exactamente esto en una carpeta de proyecto con el skill de arriba. La primera línea de la respuesta de Claude muestra que el skill se cargó y, tal como dice el skill, pidió los datos que faltaban antes de escribir nada (esa pantalla es la imagen del principio de esta guía). Respondimos con la oferta, el objetivo y la fecha de envío, y guardó el brief y enumeró lo que seguía pendiente:

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.

Qué pasó en nuestras 18 pruebas de activación

Probamos exactamente este skill en Claude Code 2.1.303 con Opus 5.5 en octubre de 2026, cada petición en una sesión nueva, junto a unos 90 skills instalados más, entre ellos un skill de briefs de contenido SEO:

Cada acierto pidió la oferta, el objetivo y las fechas que faltaban en lugar de inventarlos: la sección "Antes de escribir" en acción.

Después recortamos la descripción a "Ayudante de documentos de marketing.", y más tarde también renombramos el skill a mkt-helper. Las dos versiones siguieron cargándose en las cuatro peticiones de brief y de plan, e ignoraron una petición de texto para redes y otra de un email de agradecimiento. Eso sí, en una de las ejecuciones Claude recurrió primero a una herramienta de documentos conectada.

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, y revisa si la descripción de otro skill reclama el mismo trabajo.
• 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.
• Hace mal dos trabajos: divídelo en un skill por trabajo, cada uno con su propia descripción.
• Olvida una regla al final de una sesión larga: sube esa regla al principio. Cuando una conversación larga se compacta, Claude Code vuelve a adjuntar solo los primeros 5,000 tokens de cada skill.

¿Quieres ayuda con el ajuste? El plugin Skill Creator de Anthropic se instala con /plugin install skill-creator@claude-plugins-official. Pídele que evalúe tu skill y ejecutará prompts de prueba con y sin el skill, y luego te sugerirá cambios en la descripción.

Ajustes opcionales del frontmatter de SKILL.md

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.

Cómo hacer un skill de Claude sin escribir el archivo

No tienes que escribir SKILL.md tú. Claude puede redactarlo en tres lugares:

Convierte lo que acabamos de hacer en un skill llamado [NOMBRE-DEL-SKILL]. Conserva los pasos que funcionaron, añade como regla cada corrección que te di y escribe una descripción de menos de 200 caracteres con las frases que yo usaría para pedir esto. Muéstrame el SKILL.md antes de guardarlo.

Hacer primero la tarea importa: las correcciones que das por el camino se convierten en las reglas del skill. Lee el borrador antes de activarlo.

Cómo subir un skill a Claude (web y app de escritorio)

Los skills también funcionan en las apps web y de escritorio de Claude, en los planes Free, Pro, Max, Team y Enterprise, 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.

En Mac, un zip con la estructura correcta sale de hacer clic derecho sobre la propia carpeta campaign-brief y elegir Compress. En Windows, haz clic derecho en la carpeta y elige Compress to ZIP file (Windows 11) o Send to > Compressed (zipped) folder (Windows 10). Comprimir los archivos de dentro de la carpeta en lugar de la carpeta es la razón más común por la que falla una subida.

Instala skills de Claude desde GitHub y plugins

El repositorio público de skills de Anthropic en GitHub, una buena fuente de ejemplos de skills de Claude, 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. En la app de Claude, activas esos mismos skills de ejemplo en Customize > Skills.

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 auditar cualquier skill que no hayas escrito tú ni venga de Anthropic.

¿Los skills de Claude no funcionan? Problemas comunes y soluciones

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. 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.