Las Agent Skills son la forma más sencilla de enseñarle a un agente de inteligencia artificial a hacer una tarea siempre igual de bien, sin repetirle las instrucciones en cada chat. Basta con una carpeta y un archivo de texto llamado SKILL.md, y la misma skill funciona en herramientas como Claude Code, OpenAI Codex o GitHub Copilot en VS Code.
El formato nació en Anthropic y hoy es un estándar abierto. Esta semana dio otro paso: Anthropic cedió la marca, el dominio agentskills.io y el repositorio a la Agentic AI Foundation de la Linux Foundation, según la publicación especializada AIBriefs, que habla de más de 70 plataformas compatibles.
En esta guía te explicamos qué son las Agent Skills, cómo funcionan por dentro y cómo crear la tuya en 5 pasos, con una plantilla lista para copiar y pegar.
Tabla de contenidos
Qué son las Agent Skills
Una skill es un "manual de procedimiento" para una IA. Según la especificación oficial de Agent Skills, es una carpeta que contiene como mínimo un archivo SKILL.md con dos partes: unos metadatos (nombre y descripción) y las instrucciones que el agente debe seguir.
Además, la carpeta puede incluir scripts, documentos de referencia y plantillas. Así, en lugar de explicarle a la IA cada vez cómo quieres tus informes, tus revisiones de código o tus publicaciones, lo escribes una vez y el agente lo reutiliza.
Piensa en la diferencia con un prompt: el prompt se pierde al cerrar la conversación, mientras que las Agent Skills quedan guardadas, se pueden versionar con Git y se comparten con tu equipo.
Para qué sirven las Agent Skills: 5 usos prácticos
Estos son algunos usos reales que puedes montar desde hoy:
- Formato de documentos: que la IA siempre entregue tus informes con la misma estructura, tono y tipografía.
- Revisión de código: una lista de comprobación fija para que el agente revise seguridad, estilo y pruebas.
- Procesar archivos: extraer texto y tablas de PDF, rellenar formularios o unir documentos.
- Contenido para redes: reglas de marca, longitud de copies y número máximo de hashtags.
- Tareas repetitivas: cualquier proceso de varios pasos que hoy le explicas una y otra vez a tu asistente.
Cómo funcionan las Agent Skills por dentro
El truco que hace eficientes a las Agent Skills se llama revelación progresiva (*progressive disclosure*). El agente no carga todo de golpe, sino en tres etapas:
| Etapa | Qué carga el agente | Tamaño aproximado |
|---|---|---|
| Descubrimiento | Solo el nombre y la descripción de cada skill | Unos 100 tokens por skill |
| Activación | Las instrucciones completas del SKILL.md | Menos de 5.000 tokens recomendados |
| Ejecución | Scripts, referencias o plantillas, si hacen falta | Solo lo necesario |
Gracias a esto, un agente puede tener decenas de skills instaladas sin llenar su memoria de contexto. Por eso la descripción es la parte más importante: es lo único que el agente lee para decidir si usa o no tu skill.
Cómo crear tu primera skill en 5 pasos
Vamos con el paso a paso. Usaremos como ejemplo el tutorial oficial, que funciona en VS Code con GitHub Copilot, aunque el mismo archivo sirve en cualquier agente compatible.
Paso 1: crea la carpeta de la skill
En la raíz de tu proyecto, crea la ruta .agents/skills/ y dentro una carpeta con el nombre de tu skill, por ejemplo tirar-dados. VS Code busca las Agent Skills en .agents/skills/ por defecto.
El nombre tiene reglas estrictas: máximo 64 caracteres, solo minúsculas, números y guiones, sin empezar ni terminar en guion y sin dos guiones seguidos. Además, debe coincidir con el nombre de la carpeta.
Paso 2: escribe el archivo SKILL.md
Dentro de la carpeta, crea un archivo llamado SKILL.md. Empieza con un bloque de metadatos entre tres guiones y después escribe las instrucciones en Markdown. Esta es la plantilla mínima, lista para copiar:
---
name: tirar-dados
description: Tira dados con un generador de números aleatorios. Úsala cuando pidan tirar un dado (d6, d20, etc.) o generar una tirada al azar.
---
Para tirar un dado, ejecuta este comando, que genera un número
aleatorio entre 1 y el número de caras:
echo $((RANDOM % <caras> + 1))
Reemplaza <caras> por el número de caras del dado (6 para un
dado normal, 20 para un d20).Eso es todo: un archivo de menos de 20 líneas.
Paso 3: escribe una buena descripción
La descripción admite hasta 1.024 caracteres y debe decir qué hace la skill y cuándo usarla, con palabras clave que el usuario podría escribir. La especificación pone un ejemplo claro de lo que no se debe hacer: "Ayuda con PDF" es una mala descripción.
Una buena sería: "Extrae texto y tablas de archivos PDF, rellena formularios y une varios PDF. Úsala cuando se trabaje con documentos PDF o el usuario mencione formularios o extracción de documentos".
Paso 4: añade scripts o referencias (opcional)
Si tu skill necesita más material, organízalo en subcarpetas:
scripts/: código que el agente puede ejecutar, como Python, Bash o JavaScript.references/: documentación extra que el agente lee solo cuando la necesita.assets/: plantillas, imágenes o archivos de datos.
La recomendación oficial es mantener el SKILL.md por debajo de 500 líneas y mover el material largo a esos archivos.
Paso 5: prueba tu skill
En VS Code, abre el chat de Copilot, elige el modo Agent y escribe /skills para comprobar que tu skill aparece en la lista. Después pide algo como "tira un d20". El agente debería activar la skill, pedirte permiso para ejecutar el comando y devolverte un número del 1 al 20.
Si responde sin usar la skill, prueba con otro modelo: el propio tutorial advierte que no todos siguen las instrucciones con la misma fiabilidad.
Plantilla de Agent Skills para tus propias tareas
Esta plantilla sirve como punto de partida para casi cualquier skill. Cambia lo que está entre corchetes:
---
name: [nombre-en-minusculas]
description: [Qué hace la skill]. Úsala cuando [situaciones y palabras que diría el usuario].
---
# Objetivo
[Qué resultado debe entregar el agente]
# Pasos
1. [Primer paso concreto]
2. [Segundo paso]
3. [Cómo comprobar que quedó bien]
# Reglas
- [Lo que nunca debe hacer]
- [Formato o tono obligatorio]
# Ejemplo
Entrada: [ejemplo de petición]
Salida: [ejemplo de respuesta ideal]Dónde funcionan las Agent Skills
El formato es abierto, así que la misma skill se puede usar en distintos agentes. El tutorial oficial cita expresamente a VS Code con GitHub Copilot, Claude Code y OpenAI Codex, y AIBriefs menciona también a ChatGPT y Cursor entre las plataformas que ya lo integran.
Si quieres ver ejemplos reales antes de escribir los tuyos, Anthropic mantiene un repositorio público de skills en GitHub. Y si estás empezando con asistentes, nuestra guía de IA gratis con ChatGPT, Gemini y Grok es un buen punto de partida.
Trucos para que tus Agent Skills funcionen mejor
Estos consejos salen de la documentación oficial y de cómo cargan las skills los agentes:
- Una skill, una tarea: es mejor tener varias skills pequeñas que una enorme que lo haga todo.
- Descripción con palabras reales: incluye los términos que usarías tú al pedir la tarea.
- Instrucciones paso a paso: numeradas, concretas y con un ejemplo de entrada y salida.
- Nada de secretos: no pongas contraseñas ni claves dentro de una skill que vas a compartir.
- Revisa lo que instalas: una skill puede incluir scripts, así que solo usa las de fuentes confiables.
Ese último punto importa más de lo que parece. Como vimos con la IA de OpenAI que escapó a internet, los agentes con acceso a herramientas pueden hacer mucho más de lo previsto si nadie pone límites.
Preguntas frecuentes sobre Agent Skills
¿Las Agent Skills son gratis?
Sí. El formato es un estándar abierto y una skill es solo un archivo de texto. Lo que puede costar dinero es el agente o el modelo de IA que la ejecuta.
¿Necesito saber programar para crear una skill?
No. Una skill puede contener solo instrucciones en lenguaje natural. Los scripts son opcionales.
¿Cuál es la diferencia entre una skill y un prompt?
Un prompt se escribe en cada conversación. Una skill se guarda como archivo, el agente la carga sola cuando la tarea coincide con su descripción y se puede compartir o versionar.
¿Qué campos son obligatorios en el SKILL.md?
Solo name y description. Los campos license, compatibility, metadata y allowed-tools son opcionales.
¿Una skill de Claude funciona en otras herramientas?
En general sí, porque todas siguen la misma especificación de Agent Skills. Aun así, algunos campos como allowed-tools son experimentales y su soporte varía según el agente.
Si quieres conocer otros artículos parecidos a Agent Skills: qué son y cómo crear tu primera skill para ChatGPT, Claude o Copilot en 5 pasos puedes visitar la categoría Apps.
También te podría interesar