Skills para Claude Code, Codex y tu agente de IA

Una skill es un fichero SKILL.md que le explica a tu agente cómo se hace una cosa concreta. Se lo enseñas una vez y lo repite cada vez que haga falta, sin que se lo vuelvas a explicar.

Deja de repetirle lo mismo a tu IA

Minicurso gratis: un vídeo corto al día durante 5 días. Instalas skills y creas la tuya.

Esto es una skill entera. Sí, entera.

Eso es todo lo obligatorio. Lo demás (scripts, plantillas, ejemplos) va en la misma carpeta y tu agente lo lee cuando lo necesita.

.claude/skills/mas-vale/SKILL.md
---name: mas-valedescription: pájaro en mano--- Responde solo: “Más vale pájaro en manoque ciento volando”.

Las 5 skills imprescindibles

AnthropicAprender

1. eli5

Te explica cualquier concepto como si tuvieras 5 años, en un HTML con dibujos y metáforas.

Cuándo: Cuando aterrizas en algo que no entiendes: pagos, DNS, el sistema bancario…

npx skills add https://github.com/anthropics/claude-plugins-community --skill eli5
Ver el repo
Matt PocockPlanificar

2. grill-me

Te fríe a preguntas, cada una con su respuesta recomendada, hasta que no queda ninguna duda.

Cuándo: Antes de pedirle código. Te obliga a darle el contexto que le falta.

npx skills@latest add mattpocock/skills --skill grill-me
Leer el post
AnthropicCrear

3. skill-creator

La skill que crea skills: te pregunta, la escribe y la evalúa con y sin ella.

Cuándo: Cuando quieres convertir un artículo, una conversación o tu rutina en una skill.

npx skills add https://github.com/anthropics/skills --skill skill-creator
Leer el post
Hecha en Web ReactivaGit

4. git-commit-organizer

Agrupa tu working tree caótico en commits atómicos con Conventional Commits. Nunca hace push.

Cuándo: Al final de una sesión larga en la que has tocado de todo.

npx skills add webreactiva/skills --skill git-commit-organizer
Ver la skill
Hecha en Web ReactivaContexto

5. handoff-torch

Genera un documento de entrega para que otra sesión continúe tu tarea sin perder contexto.

Cuándo: Cuando el contexto se llena y no quieres empezar de cero.

npx skills add webreactiva/skills --skill handoff-torch
Ver la skill

¿Y la sexta?

La sexta te la haces tú, con una conversación que ya has tenido. Ninguna skill descargada se sabe tus manías.

Cómo se hace

La description de una skill no es lo que imaginas

Al arrancar, tu agente solo lee el name y la description de cada skill. Compara tu mensaje con ellas y mete entera la que encaja. Las demás no gastan contexto.

Por eso funcionan las que están en inglés aunque escribas en español: cuenta la intención.

Animación: un mensaje al agente se compara con la descripción de cada skill instalada. Solo la skill cuya descripción encaja se carga entera en el contexto; si ninguna encaja, no se carga nada.

La mejor skill no se descarga. Se cocina.

Lo llamamos Cook-First Skills. Primero resuelves la tarea con tu agente. Después escribes la skill con lo que ha pasado en la sesión. Y solo la das por buena cuando aguanta una segunda sesión real.

Y la description ya la tienes: es la frase con la que abriste la sesión.

El método completo, con ejemplos Guía premiumPlantillas SKILL.md y cómo validar tus skillsAnatomía de una skill y descriptions que hacen que salte sola.
  1. 1

    Cocina

    Resuelve la tarea con tu agente

    Por ejemplo, tu trabajo pendiente de cada mañana. Corrígele hasta que salga como tú lo harías: esas correcciones son lo que guardará la skill.

    ¿Qué trabajo tengo pendiente?
  2. 2

    Destila

    Escribe la skill al terminar

    Mejor con skill-creator instalada. De aquí sale, por ejemplo, la skill pending-work.

    Crea una skill a partir de lo que hemos hecho en esta sesión. Recoge los pasos que han funcionado, las correcciones que te he hecho y el formato de salida que hemos acordado. Usa skill-creator.
  3. 3

    Repite

    Aplica la regla de la segunda sesión

    Otro día, otros datos, la misma frase. Hasta que aguanta una segunda sesión real, la skill está escrita, no validada.

    ¿Qué tengo pendiente hoy?
  4. 4

    Refina

    Corrige la skill, no solo la salida

    Cada corrección va a la skill como nota al margen. Si solo arreglas la salida, la próxima vez fallará igual.

    Hemos usado la skill pending-work y he tenido que corregirte dos veces. Actualiza la skill para que la próxima vez no pase.

Preguntas frecuentes sobre skills

¿Qué es una skill de un agente de IA?

Es un fichero SKILL.md con instrucciones que tu agente reutiliza: una capacidad concreta que le enseñas una vez. Lleva un nombre, una descripción que le dice al agente cuándo usarla y, debajo, el cómo. Puede venir acompañada de scripts, plantillas o documentación.

¿En qué se diferencia una skill de un prompt o de un MCP?

Un prompt lo escribes cada vez; una skill se queda instalada y el agente la carga solo cuando le hace falta, así que no gasta contexto el resto del tiempo. Un MCP conecta al agente con un servicio externo (una API, una base de datos); una skill le enseña a hacer una tarea, y puede usar ese MCP por el camino.

¿Cómo instalo una skill?

Con el CLI de skills.sh: npx skills add seguido del repositorio y, si hace falta, --skill con el nombre. Detecta qué agentes tienes y deja el fichero en la carpeta correcta. También puedes copiar la carpeta a mano en .claude/skills/ si usas Claude Code o en .agents/skills/ para el resto de agentes.

¿Funcionan igual en Claude Code, Codex y OpenCode?

Sí. Agent Skills es un estándar abierto y el formato SKILL.md es el mismo. Lo que cambia es la carpeta: Claude Code las busca en .claude/skills/ y Codex, OpenCode, Cursor y compañía entienden .agents/skills/.

¿Es seguro instalar skills de terceros?

Una skill son instrucciones y, a veces, scripts que tu agente ejecuta con tus permisos. Antes de instalar, lee el SKILL.md y los ficheros que trae, o pídele a tu agente que lo revise por ti. Prefiere repositorios conocidos y desconfía de las que piden credenciales o acceso a red sin motivo.

5 vídeos para dejar de repetirte

Minicurso gratis por email. Empiezas instalando tu primera skill y acabas entendiendo por qué salta sola.