Resumen ejecutivo

• Una Agent Skill es una carpeta con un archivo SKILL.md que le enseña a un agente de IA cómo hacer una tarea concreta: instrucciones, scripts y recursos que carga solo cuando los necesita.

• El 22 de octubre, Anthropic donó el formato a la Agentic AI Foundation (AAIF), de la Linux Foundation, que ya aloja MCP y AGENTS.md. Así pasa a ser un estándar abierto con gobernanza neutral.

• Según Anthropic, más de 70 plataformas lo adoptaron, entre ellas ChatGPT, Cursor, GitHub Copilot y VS Code: una misma skill puede servir en varios agentes.

• Te mostramos paso a paso cómo crear tu primera skill, con un ejemplo completo y las reglas de la especificación.

Si usás asistentes como Claude, ChatGPT o Cursor para tareas repetitivas, seguramente copiaste más de una vez el mismo prompt largo con instrucciones, formato y ejemplos. Las Agent Skills resuelven eso: empaquetan ese conocimiento en una carpeta que el agente descubre y usa cuando la tarea lo requiere. La noticia que lo vuelve relevante ahora es que, según el anuncio de Anthropic, el formato pasó a la Agentic AI Foundation: ya no depende de una sola empresa y su evolución se decide de forma abierta. Aprender a escribir skills hoy es como haber aprendido a escribir un buen README: una habilidad que sirve en cualquier herramienta.

Qué son las Agent Skills

Una skill es una carpeta que contiene, como mínimo, un archivo SKILL.md. Ese archivo tiene un encabezado con metadatos (nombre y descripción) y, debajo, instrucciones en Markdown. Opcionalmente, la carpeta puede incluir scripts, documentos de referencia y plantillas.

La clave del diseño es la divulgación progresiva: el agente lee al principio solo el nombre y la descripción de cada skill disponible (unas pocas decenas de palabras). Cuando una tarea coincide con la descripción, carga las instrucciones completas, y solo si hace falta abre los archivos adicionales. Así podés tener muchas skills instaladas sin saturar el contexto del modelo.

Si ya conocés el Model Context Protocol (MCP), la diferencia es simple: MCP conecta al agente con herramientas y datos externos; una skill le enseña cómo hacer un trabajo, por ejemplo, con qué pasos y criterios usar esas herramientas.

Qué cambió con la donación a la AAIF

Según el comunicado de la Linux Foundation, la AAIF sumó cuatro proyectos en el mismo anuncio: Agent Skills, Open Responses, OpenEnv y OpenSandbox. Los datos principales:

• Anthropic transfirió el nombre, el logo, la organización de GitHub y el dominio agentskills.io.

• Anthropic lanzó Skills hace aproximadamente un año y publicó el formato como estándar abierto en diciembre pasado. Desde entonces, según la empresa, más de 70 plataformas lo integraron.

• El código se publica con licencia Apache 2.0 y la documentación con CC BY 4.0.

• La hoja de ruta incluye versiones numeradas de la especificación, un proceso formal de propuestas y guías de seguridad.

Para quien desarrolla o usa agentes, el efecto práctico es la portabilidad: una skill bien escrita debería funcionar en distintos agentes compatibles sin reescribirla. Si querés el contexto del lanzamiento original, leé cuando Anthropic lanzó Skills para Claude.

La estructura de una skill según la especificación

La especificación oficial define estas reglas:

• Carpeta: su nombre tiene que coincidir con el campo name.

• name (obligatorio): hasta 64 caracteres, solo minúsculas, números y guiones, sin guiones al principio, al final ni dobles.

• description (obligatorio): hasta 1.024 caracteres. Tiene que decir qué hace la skill y cuándo usarla. Es lo que el agente lee para decidir si la activa.

• Campos opcionales: license, compatibility, metadata y allowed-tools (experimental).

• Carpetas opcionales: scripts/ (código ejecutable), references/ (documentación adicional) y assets/ (plantillas, imágenes, datos).

• Tamaño recomendado: el cuerpo del SKILL.md por debajo de 500 líneas; el detalle extra va en references/.

Tutorial: tu primera skill paso a paso

Vamos a crear una skill que redacta notas de versión (release notes) a partir de una lista de cambios.

Paso 1: creá la carpeta

release-notes/
├── SKILL.md
└── assets/
    └── plantilla.md

release-notes/
├── SKILL.md
└── assets/
    └── plantilla.md

release-notes/
├── SKILL.md
└── assets/
    └── plantilla.md

release-notes/
├── SKILL.md
└── assets/
    └── plantilla.md

Paso 2: escribí el SKILL.md

---
name: release-notes
description: Redacta notas de versión claras para usuarios finales a partir de una lista de commits o cambios. Usala cuando te pidan release notes, changelog o un resumen de novedades de una versión.
license: Apache-2.0
---

# Notas de versión

## Pasos
1. Agrupá los cambios en: Novedades, Mejoras y Correcciones.
2. Reescribí cada cambio en lenguaje de usuario, sin jerga interna.
3. Descartá cambios internos (refactors, dependencias) salvo que afecten al usuario.
4. Usá la estructura de assets/plantilla.md.

## Criterios
- Una línea por cambio, empezando con un verbo.
- Si un cambio rompe compatibilidad, destacalo al principio.
- No inventes funcionalidades que no estén en la lista

---
name: release-notes
description: Redacta notas de versión claras para usuarios finales a partir de una lista de commits o cambios. Usala cuando te pidan release notes, changelog o un resumen de novedades de una versión.
license: Apache-2.0
---

# Notas de versión

## Pasos
1. Agrupá los cambios en: Novedades, Mejoras y Correcciones.
2. Reescribí cada cambio en lenguaje de usuario, sin jerga interna.
3. Descartá cambios internos (refactors, dependencias) salvo que afecten al usuario.
4. Usá la estructura de assets/plantilla.md.

## Criterios
- Una línea por cambio, empezando con un verbo.
- Si un cambio rompe compatibilidad, destacalo al principio.
- No inventes funcionalidades que no estén en la lista

---
name: release-notes
description: Redacta notas de versión claras para usuarios finales a partir de una lista de commits o cambios. Usala cuando te pidan release notes, changelog o un resumen de novedades de una versión.
license: Apache-2.0
---

# Notas de versión

## Pasos
1. Agrupá los cambios en: Novedades, Mejoras y Correcciones.
2. Reescribí cada cambio en lenguaje de usuario, sin jerga interna.
3. Descartá cambios internos (refactors, dependencias) salvo que afecten al usuario.
4. Usá la estructura de assets/plantilla.md.

## Criterios
- Una línea por cambio, empezando con un verbo.
- Si un cambio rompe compatibilidad, destacalo al principio.
- No inventes funcionalidades que no estén en la lista

---
name: release-notes
description: Redacta notas de versión claras para usuarios finales a partir de una lista de commits o cambios. Usala cuando te pidan release notes, changelog o un resumen de novedades de una versión.
license: Apache-2.0
---

# Notas de versión

## Pasos
1. Agrupá los cambios en: Novedades, Mejoras y Correcciones.
2. Reescribí cada cambio en lenguaje de usuario, sin jerga interna.
3. Descartá cambios internos (refactors, dependencias) salvo que afecten al usuario.
4. Usá la estructura de assets/plantilla.md.

## Criterios
- Una línea por cambio, empezando con un verbo.
- Si un cambio rompe compatibilidad, destacalo al principio.
- No inventes funcionalidades que no estén en la lista

Paso 3: agregá la plantilla

En assets/plantilla.md dejá el formato exacto que querés: título con la versión, secciones y un cierre. Separarlo del SKILL.md mantiene las instrucciones cortas.

Paso 4: validá la skill

La especificación ofrece la herramienta de referencia skills-ref para comprobar que el encabezado y los nombres cumplen las reglas:

skills-ref validate ./release-notes

skills-ref validate ./release-notes

skills-ref validate ./release-notes

skills-ref validate ./release-notes

Paso 5: instalala y probala

Cada agente compatible tiene su propia carpeta o mecanismo para cargar skills; revisá la documentación de la herramienta que uses. Después, probá con un pedido que coincida con la descripción («armame las release notes de estos cambios») y con otro que no, para verificar que se active solo cuando corresponde.

Buenas prácticas

• Descripción específica: incluí las palabras que usaría alguien al pedir la tarea. Una descripción vaga hace que la skill no se active o se active de más.

• Una skill, un trabajo: mejor varias skills chicas que una gigante.

• Scripts para lo determinístico: si un paso siempre es igual (convertir un formato, validar datos), conviene un script en lugar de instrucciones en texto.

• Seguridad: instalá skills solo de fuentes confiables y revisá sus scripts antes de usarlas, porque pueden ejecutar código en tu entorno.

• Versionado: guardá tus skills en un repositorio Git para compartirlas con tu equipo.

Para entender el ecosistema completo, mirá nuestra guía sobre qué son los agentes de IA y cómo usarlos.

Cursos recomendados de Coderhouse

Si querés diseñar y construir agentes que usen skills, herramientas y memoria, el curso de AI Agents es el paso natural. Si buscás una base más técnica para llevar soluciones de IA a producción, mirá AI Engineering.

Preguntas frecuentes

¿Necesito saber programar para crear una skill? No para una skill básica: alcanza con escribir buenas instrucciones en Markdown. Programar te sirve para sumar scripts.

¿Las skills funcionan solo con Claude? No. Al ser un estándar abierto, las adoptaron muchas plataformas, como ChatGPT, Cursor, GitHub Copilot y VS Code. Igual conviene probar cada skill en el agente que vayas a usar.

¿En qué se diferencia una skill de un prompt guardado? Una skill se activa sola según su descripción, puede incluir scripts y archivos, y se carga de a partes para no ocupar contexto innecesario.

¿Quién decide ahora cómo evoluciona el estándar? La comunidad, a través de la Agentic AI Foundation, con un proceso formal de propuestas y versiones de la especificación.