Claude Skills: qué son y cómo crear la tuya

Una skill es una carpeta con un archivo SKILL.md (nombre, descripción e instrucciones) y, si hace falta, scripts y documentos de apoyo, que enseña a Claude a hacer una tarea concreta siempre de la misma manera. Claude solo lee el nombre y la descripción de cada skill hasta que una tarea la necesita, y entonces carga el resto, así que puedes tener decenas instaladas sin que ocupen apenas contexto. Anthropic las presentó el 16 de octubre de 2025 y en diciembre las publicó como estándar abierto, Agent Skills, que hoy entienden también Codex, Gemini, Cursor o GitHub Copilot.

Datos de la documentación oficial de cada herramienta, a 13 de octubre de 2026.

Qué son las skills de Claude y para qué sirven

Anthropic las define como «carpetas de instrucciones, scripts y recursos que Claude carga de forma dinámica» para hacer tareas de forma repetible. Su equipo de ingeniería lo compara con preparar la guía de bienvenida de alguien que acaba de entrar en la empresa. En la interfaz de Claude en español se llaman «Habilidades».

Sirven para lo que ahora le explicas a Claude una y otra vez. Los ejemplos del centro de ayuda: aplicar la guía de marca de tu empresa a documentos y presentaciones, escribir correos con las plantillas de la casa o crear tareas en Jira, Asana o Linear según vuestras normas. Si has pedido a Claude un Word o un Excel en el chat, ya has usado una: los genera con las skills de Anthropic para Word, Excel, PowerPoint y PDF.

Las hay de dos tipos, según la documentación de Claude Code: de referencia, con conocimiento que Claude aplica mientras trabaja (tu guía de estilo), y de tarea, con los pasos de una acción concreta (publicar una versión, hacer un commit). En el fondo, una skill le da a un agente de IA el oficio que le falta: el modelo ya sabe razonar, y la skill le cuenta cómo se hacen las cosas en tu casa.

Cómo funcionan: Claude solo lee lo que necesita

Anthropic lo llama divulgación progresiva: la skill se carga en tres niveles. Así lo cuenta la documentación de la plataforma, a 13 de octubre de 2026:

Un ejemplo de la propia documentación: tienes una skill de PDF y pides «extrae el texto de este PDF y resúmelo». Claude ve que encaja con la descripción, lee el SKILL.md y sigue sus pasos, pero no abre el archivo de la misma carpeta sobre cómo rellenar formularios: no le hace falta. Si la skill trae un script, lo ejecuta sin leer su código: a su ventana de contexto solo llega lo que el script imprime.

Dónde se usan las skills en Claude

En la app de Claude (web y escritorio)

Según el centro de ayuda de Claude, las skills están en todos los planes, también el gratuito (al lanzarse, en octubre de 2025, eran solo de pago). Necesitan la ejecución de código: en Configuración, Capacidades, activa «Ejecución de código y creación de archivos», y en Personalizar, Habilidades, enciende o apaga cada una. Las de documentos de Anthropic funcionan solas.

Para subir una tuya, comprime la carpeta en un ZIP (la carpeta dentro, no sus archivos sueltos) y en Personalizar, Habilidades, pulsa «+», «+ Crear habilidad» y «Cargar una habilidad». Si falla, suele ser porque la carpeta no se llama como la skill o falta el SKILL.md.

En Claude Code

En Claude Code una skill es una carpeta en ~/.claude/skills/<nombre>/, para ti en todos tus proyectos, o en .claude/skills/<nombre>/, dentro del repositorio, para compartirla con el equipo por git. Claude la usa sola cuando tu petición encaja con la descripción, o la llamas tú con /nombre: los antiguos comandos personalizados se han fusionado con las skills. /skills enseña las cargadas, y desde la versión 2.1.273 se descargan también las de tu cuenta de Claude.

Trae algunas de serie, como /code-review o /debug. Las de documentos de Anthropic no vienen incluidas, pero se instalan desde su repositorio:

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

En la API

En la API de Claude, las skills funcionan con la herramienta de ejecución de código y se pasan en el parámetro container, hasta 20 por petición. Este ejemplo, basado en la guía oficial, usa la de PowerPoint:

import anthropic

client = anthropic.Anthropic()

respuesta = client.messages.create(
    model="claude-opus-5-5",
    max_tokens=4096,
    container={
        "skills": [{"type": "anthropic", "skill_id": "pptx", "version": "latest"}]
    },
    messages=[{"role": "user", "content": "Crea una presentación sobre energías renovables"}],
    tools=[{"type": "code_execution_20250825", "name": "code_execution"}],
)

Las tuyas se suben con POST /v1/skills (menos de 30 MB) y sirven a todo el espacio de trabajo. Ojo: en la API se ejecutan sin acceso a internet y sin poder instalar paquetes.

Cómo crear una skill paso a paso

1. Elige una tarea que repites. La pista de la documentación de Claude Code: si pegas el mismo procedimiento en el chat por tercera vez, es una skill.

2. Crea la carpeta. Su nombre será el de la skill. Para Claude Code, en tu carpeta personal:

mkdir -p ~/.claude/skills/guia-de-marca

3. Escribe la cabecera. El SKILL.md empieza con dos campos obligatorios entre líneas ---. Según la especificación, el name lleva de 1 a 64 caracteres (minúsculas, números y guiones, sin empezar ni acabar en guion) y coincide con el nombre de la carpeta; en la API de Claude, además, no puede contener «anthropic» ni «claude». La description admite hasta 1.024 caracteres. Claude Code añade campos propios, como disable-model-invocation: true, que impide que Claude la active por su cuenta: úsalo en las que publican, envían o borran algo.

4. Escribe el cuerpo. Pasos claros y ejemplos. La guía de buenas prácticas pide ser breve («Claude ya es muy listo»: explica solo lo que no sabe) y no pasar de 500 líneas.

5. Añade referencias y scripts si hacen falta. Lo largo, en archivos aparte enlazados directamente desde el SKILL.md. Lo que debe salir siempre igual (validar, convertir), mejor en un script.

6. Pruébala. Pide algo que encaje con la descripción sin nombrar la skill y mira si la usa; si no, afina la descripción. Para la app de Claude, comprímela en un ZIP y súbela.

Un ejemplo completo

Esta skill está basada en el ejemplo de guía de marca del centro de ayuda de Claude, con su empresa ficticia, Acme, y adaptada al formato del estándar. La carpeta:

guia-de-marca/
├── SKILL.md
├── references/
│   └── tono.md
└── assets/
    ├── logo-color.png
    └── logo-blanco.png

Y el SKILL.md:

---
name: guia-de-marca
description: Aplica la guía de marca de Acme (colores, tipografías y uso del logo) a presentaciones, documentos e informes. Úsala al crear o revisar presentaciones, documentos de Word, informes para clientes o material de marketing de Acme.
---

# Guía de marca de Acme

## Colores
- Principal: #FF6B35 (coral)
- Secundario: #004E89 (azul marino)
- Acento: #F7B801 (dorado)
- Neutro: #2E2E2E (carbón)

## Tipografía
- Títulos en Montserrat Bold; texto en Open Sans Regular.
- Tamaños: título 32 pt, subtítulo 24 pt, texto 11 pt.

## Logo
- Sobre fondo claro, assets/logo-color.png; sobre oscuro, assets/logo-blanco.png.
- Deja al menos 1,3 cm libres alrededor del logo.

## Textos
Si el encargo incluye redactar, lee antes references/tono.md.

Cómo escribir la descripción (y los errores habituales)

La descripción es lo único que Claude ve de una skill hasta que la abre: con ella decide si la usa. Tiene que decir qué hace y cuándo usarla, con las palabras que dirías al pedirlo. Los errores que más se repiten:

• Ser vaga. «Ayuda con documentos» es el ejemplo de lo que no hay que hacer de la guía de Anthropic; «Extrae texto y tablas de PDF, rellena formularios. Úsala con archivos PDF», el bueno.
• Decir qué hace pero no cuándo. Sin el «úsala cuando…», Claude no sabe en qué peticiones encaja.
• Hablar en primera o segunda persona. La guía pide tercera: «Genera informes», no «Puedo ayudarte con informes».
• Dejar lo importante para el final. Claude Code corta cada descripción a 1.536 caracteres y, si tienes muchas skills, quita la descripción a las que menos usas.
• Solaparse con otra. Con dos descripciones parecidas, Claude puede cargar la que no es.
• Pasarse de 200 caracteres. El estándar admite 1.024, pero el centro de ayuda de claude.ai pone el tope en 200: escribe para 200 y valdrá en todas partes.
• Confiarle una regla que no puede fallar. Claude interpreta; lo que tiene que pasar siempre, en Claude Code, va en un hook.

Agent Skills: en qué otras herramientas funcionan

El 18 de diciembre de 2025, Anthropic publicó el formato como estándar abierto en agentskills.io, donde a 13 de octubre de 2026 aparecían más de 40 productos compatibles. Las skills de IA ya no son cosa de un solo fabricante. Dónde busca cada herramienta, según su documentación a esa fecha:

Un detalle práctico: Cursor lee también las carpetas de Claude y GitHub Copilot acepta .claude/skills/ en el repositorio, así que una skill guardada ahí sirve a la vez para los tres.

En Codex se llaman con $nombre. Según esa misma página de OpenAI, ChatGPT las admite sueltas en la app de escritorio y dentro de plugins en la web y el móvil. Gemini CLI pide permiso antes de activar cada una, aunque para las cuentas gratuitas y de Google One, Google lo sustituyó por Antigravity CLI el 18 de junio de 2026. Y la app de Gemini estrena skills desde el 30 de septiembre de 2026 (cuentas personales, mayores de 18): se puede subir un SKILL.md y sustituyen a los Gems, que se convertirán solos en skills a partir de noviembre.

Fuera de la programación, Hermes Agent, de Nous Research, crea sus propias skills tras una tarea compleja y las mejora con el uso, según su README. Y OpenClaw, el asistente que instalas en casa, sigue el mismo formato.

Skills que merece la pena conocer

Las oficiales de Anthropic

El repositorio anthropics/skills (180.801 estrellas el 13 de octubre de 2026) reúne 19: las de documentos, con el código visible pero sin licencia abierta, y ejemplos con licencia Apache 2.0. Para empezar: skill-creator, que crea skills, las prueba y afina su descripción; frontend-design, para interfaces con diseño propio; y webapp-testing, que prueba aplicaciones web con Playwright. El propio repositorio avisa de que son ejemplos para aprender.

Superpowers

Superpowers, de Jesse Vincent, es una de las colecciones de skills para programar más populares: 298.351 estrellas en GitHub el 13 de octubre de 2026, con licencia MIT. Más que conocimiento, impone un método: el agente te pregunta hasta tener claro el diseño, parte el trabajo en tareas de 2 a 5 minutos, escribe primero una prueba que falla y encarga cada tarea a un subagente nuevo, con revisión contra el plan antes de seguir. En Claude Code se instala con:

/plugin install superpowers@claude-plugins-official

También está para Codex, Cursor, Gemini CLI y otros. Nuestro criterio: compensa en funcionalidades de varias horas; para cambiar una línea es más ceremonia que ayuda.

Para buscar más, mattpocock/skills (288.495 estrellas) tiene skills pequeñas como grill-me, que hace que el agente te interrogue antes de empezar, y el directorio skills.sh, de Vercel, las ordena por instalaciones y las instala con npx skills add usuario/repositorio.

Skills o MCP: en qué se diferencian

MCP conecta a Claude con servicios externos: le da herramientas y datos, como tu base de datos o tu Notion. Una skill le da conocimiento de procedimiento: cómo hacer algo. Se combinan: en el ejemplo de la documentación de Claude Code, MCP conecta la base de datos y una skill documenta el esquema y las consultas habituales. Notion, Figma o Atlassian ya publican skills pensadas para sus conectores MCP.

Skills, CLAUDE.md y subagentes

CLAUDE.md se carga entero en cada sesión: es para lo que Claude debe saber siempre («usa pnpm, no npm»). La skill, solo cuando hace falta. Anthropic recomienda dejar CLAUDE.md por debajo de 200 líneas y pasar el material de consulta a skills. Un subagente es otra cosa: un trabajador con su propia ventana de contexto que te devuelve un resumen, y una skill con context: fork se ejecuta en uno.

¿Son seguras las skills? Lo que pasó en ClawHub

Una skill puede traer scripts que se ejecutan con tus permisos. Anthropic recomienda usar solo las de fuentes de confianza, las tuyas o las suyas, y auditar a fondo cualquier otra: una maliciosa puede llevarse tus datos.

El caso que lo demostró fue ClawHub, la tienda de skills de OpenClaw. El 1 de febrero de 2026, Koi Security revisó sus 2.857 skills y encontró 341 maliciosas, el 11,9 %; 335 eran de una sola campaña, ClawHavoc. Se hacían pasar por herramientas de criptomonedas o de YouTube, con una sección de «requisitos previos» que pedía descargar un ZIP con contraseña (en Windows) o pegar un comando en la terminal (en macOS). Lo que se instalaba en el Mac era Atomic Stealer, que roba contraseñas, datos del navegador, carteras de criptomonedas y claves SSH. Hoy ClawHub enseña un análisis de seguridad antes de instalar, según la documentación de OpenClaw.

En Claude Code hay un riesgo menos evidente: una skill de proyecto puede darse permisos con allowed-tools, y Claude Code lo aplica incluso con claude -p en una carpeta en la que nunca has confirmado que confías. Si clonas un repositorio ajeno, mira su .claude/skills/ antes de nada.

Antes de instalar una skill de terceros, comprueba esto:

1. Quién la publica. Tú, Anthropic o un autor con nombre y un repositorio con historia.
2. El nombre exacto. En ClawHub, 29 skills imitaban el nombre de la herramienta oficial de la tienda, con variantes como clawhub1, clawhubb o cllawhub.
3. El SKILL.md entero. Desconfía de cualquier paso que te pida descargar algo o pegar un comando.
4. Cada script. Busca llamadas a internet (curl, webhooks), texto en base64 y lecturas de .env o ~/.ssh.
5. La cabecera. Un allowed-tools amplio o un campo hooks permiten ejecutar cosas sin preguntarte.
6. Las actualizaciones. Revisa qué cambia; los plugins se actualizan solos.
7. Dónde la pruebas. La primera vez, en un proyecto sin credenciales.

Por dónde seguir

• El marco general, qué es un agente y cuándo compensa, está en qué es un agente de IA.
• Para conectar a Claude con tus herramientas, el complemento natural de las skills es MCP explicado paso a paso.
• Y si quieres crear tu primera skill en la terminal, empieza por el tutorial de Claude Code en español.