Skills de Claude Code: qué son, cómo instalarlas y cómo pedirle a Claude que las use

Las skills de Claude Code son la forma más sencilla de enseñarle a Claude un procedimiento y que lo repita igual cada vez: publicar un post, auditar una web, generar una ilustración o revisar un contrato. En esta guía verás qué es una skill por dentro, dónde se instala, cómo pedirle a Claude que la use y cómo compartirla con tu equipo. Todo está probado con Claude Code 2.1.284 en Windows 11.

Si vienes buscando una skill concreta, en este blog ya hemos analizado social-media-skills para LinkedIn e Instagram y Anatomy, la skill que dibuja figuras isométricas interactivas. Esta guía es la base para entender ambas.

Qué es una skill de Claude Code

Una skill es una carpeta con un archivo SKILL.md. Ese archivo tiene dos partes:

1. Un encabezado YAML con el name y la description. La descripción le dice a Claude *cuándo* debe usar la skill.
2. Instrucciones en Markdown: los pasos, las reglas y los criterios de calidad que Claude sigue cuando la skill se activa.

Junto al SKILL.md puede haber más archivos: guías de referencia, plantillas, scripts de Node o Python y ejemplos. Claude los abre solo cuando los necesita.

---
name: checklist-entrega
description: Revisa que una web esté lista para entregar al cliente (SEO básico, formularios, enlaces rotos, legales). Úsala cuando pidan "revisar antes de entregar" o "checklist de entrega".
---

1. Lista las páginas del proyecto y comprueba que cada una tenga title y meta description.
2. Prueba cada formulario y anota qué ocurre al enviarlo.
3. Busca enlaces rotos e imágenes sin texto alternativo.
4. Comprueba que existan política de privacidad y aviso de cookies.
5. Devuelve una tabla: elemento, estado, cómo arreglarlo.

Ese es un ejemplo completo y funcional. No hay que compilar nada ni registrar la skill en ningún sitio.

Skill, CLAUDE.md, plugin o MCP: qué es cada cosa

La diferencia práctica con CLAUDE.md: el cuerpo de una skill solo ocupa contexto cuando se usa. Por eso una skill puede tener cientos de líneas de guía sin encarecer tus conversaciones normales.

El estándar Agent Skills: una skill, varios asistentes

Las skills de Claude Code siguen el estándar abierto Agent Skills. La misma carpeta funciona, con pocos o ningún cambio, en Codex, OpenCode y Antigravity. Si tu equipo usa asistentes distintos, una skill bien escrita sirve para todos.

Dónde se instalan las skills

La ubicación decide en qué sesiones está disponible la skill:

En Windows, ~ es tu carpeta de usuario (C:\Users\<tu-usuario>\.claude\skills).

Regla práctica: personal para tus herramientas de trabajo (redactar, revisar), proyecto para todo lo que depende del repositorio (desplegar, publicar, convenciones del cliente).

Cómo instalar una skill paso a paso

Hay tres formas. Las tres dejan el mismo resultado: una carpeta con su SKILL.md en una de las rutas anteriores.

Opción 1: con la CLI skills (la más cómoda)

`skills` es una CLI de código abierto que descarga una skill desde GitHub y la copia en la carpeta correcta para cada asistente. Necesita Node.js reciente: la versión 1.7.x pide Node 22.20 o superior.

# En el proyecto actual (.claude/skills/)
npx skills add usuario/repositorio -a claude-code

# Para tu usuario, en todos los proyectos (~/.claude/skills/)
npx skills add usuario/repositorio -g -a claude-code

-a elige el asistente (claude-code, codex, opencode, antigravity) y -g instala a nivel de usuario. Sin -y, la CLI te hace preguntas interactivas; con -y acepta las opciones por defecto.

Fíjate en la última línea: *"Review skills before use; they run with full agent permissions"*. Una skill puede pedirle a Claude que ejecute comandos, así que lee el SKILL.md antes de usar una skill de un desconocido.

Opción 2: con git

git clone https://github.com/usuario/repositorio.git ~/.claude/skills/nombre-skill

Para actualizarla después, git pull dentro de esa carpeta. Si clonas en una ruta muy larga en Windows y aparece Filename too long, clona en una ruta corta (por ejemplo C:\src) o usa git -c core.longpaths=true clone ....

Opción 3: escribirla tú

Crea la carpeta y el archivo:

mkdir -p .claude/skills/checklist-entrega

Pega dentro un SKILL.md como el del ejemplo de arriba. Claude Code vigila las carpetas de skills y la detecta en la sesión abierta, sin reiniciar. La única excepción: si la carpeta skills no existía cuando arrancaste la sesión, ejecuta /reload-skills.

Cómo pedirle a Claude que use una skill

1. Invocarla por su nombre

Escribe / seguido del nombre al principio del mensaje y, a continuación, lo que quieres:

/checklist-entrega revisa la web del cliente en la carpeta sitio/

Así la skill se ejecuta seguro. Si escribes el nombre en mitad de una frase ("revisa esto y luego usa /checklist-entrega"), Claude lo toma como permiso para usarla, pero decide él si hace falta.

2. Dejar que Claude la elija sola

Al iniciar la sesión, Claude solo ve el nombre y la descripción de cada skill. Si tu petición encaja con una descripción, carga la skill sin que la nombres. Por eso una buena descripción incluye las frases que diría un usuario: "revisar antes de entregar", "checklist de entrega".

Para saber qué skills ve Claude en tu sesión, pregúntale directamente: *"¿Qué skills tienes disponibles?"*. El menú /skills también las lista.

3. Cómo escribir buenas peticiones

• Di el resultado, no los pasos. La skill ya tiene los pasos; tú aportas el contexto: qué proyecto, qué cliente, qué formato de salida.
• Da datos reales. Cifras, URLs, nombres de archivos. Las buenas skills los usan en lugar de inventar.
• Di dónde va el resultado. "Guárdalo en docs/", "como componente React", "en una sola página HTML".
• Revisa y pide la segunda vuelta. La mayoría de skills están pensadas para iterar: "el título es demasiado largo, acórtalo y vuelve a validar".

Controlar quién lanza la skill

Dos campos del encabezado cambian el comportamiento:

En este blog, por ejemplo, la skill que publica artículos en Sanity se lanza a mano. No queremos que Claude decida publicar porque un texto "parece listo".

Skills en proyectos reales y en agencias

Las skills brillan cuando un procedimiento se repite. Algunos usos que funcionan:

• Publicar contenido: este blog tiene una skill escribir-post que investiga, escribe en español e inglés, valida el SEO y publica. Cada artículo sale con la misma estructura sin repetir instrucciones.
• Convenciones por cliente: una carpeta .claude/skills/ en cada repositorio de cliente con su guía de estilo, su proceso de despliegue y sus reglas legales. Quien entre al proyecto, persona o agente, trabaja igual.
• Entregables visuales: skills como Anatomy generan ilustraciones técnicas interactivas para landings y documentación.
• Auditorías: SEO, accesibilidad o la revisión legal de una web hecha con IA, siempre con la misma lista de comprobación.

Para una agencia, la clave es subir las skills al repositorio. Así forman parte del proyecto, se revisan en los pull requests y no dependen de la configuración del portátil de nadie.

Errores frecuentes

La skill no aparece en /

Comprueba que la ruta sea exactamente .../skills/<nombre>/SKILL.md (no skills/SKILL.md ni skills/<nombre>/<nombre>/SKILL.md). Es un fallo habitual al descomprimir un ZIP de GitHub, que crea una carpeta extra nombre-main. Si creaste la carpeta skills con la sesión ya abierta, ejecuta /reload-skills.

Claude no usa la skill aunque la petición encaja

Revisa la descripción: debe contener las palabras que usarías al pedirlo. Si el YAML del encabezado está mal formado, la skill funciona con /nombre pero Claude no puede emparejarla con tus peticiones. claude plugin validate .claude/skills detecta esos errores.

Claude deja de seguir la skill a mitad de la sesión

Tras una compactación de la conversación, Claude Code solo conserva el principio de cada skill. Vuelve a invocarla con /nombre. Si escribes tus propias skills, pon lo más importante al principio del SKILL.md.

npx skills add falla con un error de versión de Node

La CLI 1.7.x necesita Node 22.20 o superior. Comprueba tu versión con node -v y actualiza.

Preguntas frecuentes

¿Las skills de Claude Code son gratis?

La función viene incluida en Claude Code. Las skills de la comunidad suelen ser de código abierto (MIT en los casos que hemos revisado). Lo que pagas es tu plan de Claude y, si la skill los usa, los servicios externos.

¿Funcionan en Claude Desktop o en claude.ai?

Sí, con matices. En claude.ai y Claude Desktop se suben como ZIP desde la configuración de skills, y las skills activadas en tu cuenta también se sincronizan con Claude Code.

¿Una skill puede ejecutar comandos en mi ordenador?

Puede pedirle a Claude que los ejecute, y Claude lo hará con los permisos que tenga tu sesión. Por eso conviene leer el SKILL.md y los scripts que incluye antes de instalarla.

¿Necesito saber programar para crear una skill?

No. Una skill es un archivo Markdown con instrucciones claras. Los scripts son opcionales.

¿Qué diferencia hay entre una skill y un comando de .claude/commands/?

Hoy son lo mismo: Claude Code fusionó los comandos personalizados con las skills. Los archivos antiguos de .claude/commands/ siguen funcionando, pero las skills admiten archivos de apoyo y activación automática.

Conclusión

Una skill es un SKILL.md en la carpeta correcta: se instala con npx skills add, con git o escribiéndola tú, y se usa con /nombre o dejando que Claude la elija por su descripción. El siguiente paso es probar una de verdad. En la guía de Anatomy instalamos una skill de la comunidad y la usamos para generar una ilustración interactiva real.