Qué son los Skills en agentes de IA: SKILL.md explicado con ejemplos reales
Los Skills son carpetas con instrucciones que un agente de IA carga solo cuando las necesita. Cómo funcionan, con ejemplos reales de Claude y OpenCode.
kamerrezz
18 de julio de 2026
Qué son los Skills en agentes de IA: SKILL.md explicado con ejemplos reales
Le pides a tu agente de IA que te genere una presentación y te entrega una diapositiva con Arial, un título gigante y un color por sección. Se ve a IA a un kilómetro. Le pides un Excel con proyecciones financieras y no hay forma de saber, con solo mirarlo, cuáles celdas son datos que metiste tú y cuáles son fórmulas que calculó el modelo.
El agente no es malo generando contenido. El problema es que nadie le enseñó las reglas del oficio — las que un diseñador o un analista financiero con experiencia ya trae incorporadas.
Eso es exactamente lo que resuelven los Skills.
Un Skill, en una frase
Un Skill es una carpeta con un archivo SKILL.md adentro que le enseña a un agente de IA cómo hacer bien una tarea específica — y el agente la usa solo cuando la tarea lo pide, no siempre.
Nada de fine-tuning, nada de reentrenar el modelo. Es un archivo de texto que empaqueta el "así lo hacemos acá" para que no lo tengas que repetir en cada conversación.
Cómo se ve por dentro (con un ejemplo real)
Anthropic, la empresa detrás de Claude, publicó a fines de 2025 un repositorio con Skills de uso libre para tareas de documentos: PowerPoint, Excel, Word y PDF. Así se ve el de hojas de cálculo por dentro:
xlsx/
SKILL.md
scripts/
validar_formulas.py
references/
convenciones-modelos-financieros.md
Y dentro del SKILL.md no hay generalidades tipo "haz una buena hoja de cálculo". Hay reglas concretas, del tipo que un analista financiero senior sí conoce y un modelo por defecto no:
- Las celdas de entrada de datos van en azul.
- Las fórmulas van en negro.
- Los links a otras hojas van en verde; los links a archivos externos, en rojo.
- Antes de entregar el archivo, valida que no queden errores tipo
#REF!,#DIV/0!o#N/A.
El skill de presentaciones (pptx) trae reglas igual de específicas: un color principal debe ocupar entre el 60% y el 70% del diseño, evitar fuentes genéricas como Arial, y los títulos van entre 36 y 44pt. Nada de eso lo escribiste tú en el prompt — ya viene en el archivo, y el agente lo aplica solo.
Por qué no es lo mismo que un prompt largo
Acá está el punto que casi nadie explica bien: el agente no carga todos los Skills a la vez.
Al arrancar, solo lee el nombre y la descripción de cada Skill disponible — un par de líneas por cada uno. Eso ocupa casi nada de contexto. Recién cuando detecta que tu pedido coincide con la descripción de un Skill, lo carga completo y lo sigue paso a paso. Si le pides "escríbeme un poema" y tienes 15 Skills de finanzas guardados, ninguno se activa. No hay gasto de tokens de más, ni ruido innecesario.
A ese mecanismo se le llama progressive disclosure: el agente sabe que la herramienta existe, pero solo la abre cuando la necesita. Es la diferencia entre tener un manual de 40 páginas sobre el escritorio todo el tiempo y tener una biblioteca donde vas directo al libro correcto.
Dónde vas a encontrarlos
El formato SKILL.md nació con Claude, pero desde diciembre de 2025 es un estándar abierto — y hoy lo soportan más de 30 agentes distintos: Claude Code, OpenCode, Cursor, Gemini CLI, GitHub Copilot, entre otros. Un Skill que escribes hoy para uno de estos, lo puedes mover al siguiente sin reescribirlo.
Normalmente convive con otras piezas del agente:
| Pieza | Responde a |
|---|---|
| agents | ¿Quién hace la tarea? |
| commands | ¿Qué acción dispara el usuario? |
| skills | ¿Cómo se hace bien esa acción? |
| plugins / tools | ¿Con qué se conecta el agente al mundo real? |
Un Skill no reemplaza a un comando ni a un agente. Es el "cómo" que ambos van a buscar cuando lo necesitan.
El caso que lo deja clarísimo: rellenar un PDF
Claude ya sabe leer un PDF de memoria — eso viene del modelo. Lo que no sabe hacer de forma nativa es editarlo: rellenar un formulario campo por campo, respetando el layout exacto del documento original.
El Skill de PDF resuelve justo eso: le da al agente el procedimiento técnico para detectar los campos del formulario, mapear cada dato al lugar correcto y devolver el archivo editado sin romper el diseño. Es la diferencia entre "Claude entiende de PDFs" y "Claude te rellena este formulario de la SAT sin que tengas que abrir Acrobat".
Por qué te conviene armar los tuyos
Si programas con un agente de IA todos los días, seguro ya viviste esto: le explicas la estructura de carpetas de tu proyecto, tu convención de commits, cómo manejas los errores en tu API — y a la sesión siguiente, se lo tienes que explicar otra vez.
Un Skill propio corta ese ciclo. Lo escribes una vez — "en este proyecto los endpoints van en controllers/, los servicios en services/, y todo error HTTP pasa por el middleware errorHandler" — y el agente lo respeta en cada sesión nueva, sin que se lo repitas.
No hace falta ser experto en IA para armar uno. Hace falta identificar una tarea que repites seguido, escribir cómo la haces bien (con ejemplos, no generalidades) y guardarla donde el agente la encuentre.