Agent Skills pasa a la Agentic AI Foundation: qué cambia y cómo escribir skills portables

El 22 de octubre de 2026 Anthropic anunció que dona Agent Skills a la Agentic AI Foundation (AAIF). Agent Skills es el estándar abierto detrás de los skills que usas en Claude Code: una carpeta con un archivo SKILL.md que le enseña a un agente una tarea concreta.

Si ya escribes skills, la noticia no te obliga a cambiar nada. Pero sí es buen momento para revisar si tus skills funcionarían en otro agente, porque el estándar ahora tiene una casa neutral y lo mantienen ingenieros de varias empresas. En este artículo te cuento qué se donó, qué dice la especificación y qué campos del SKILL.md son portables y cuáles solo funcionan en Claude Code.

Todo lo que sigue sale de la nota de Anthropic, de la especificación en agentskills.io y de la documentación de Claude Code, consultadas el 6 de noviembre de 2026.

Qué anunció Anthropic

Según la nota del 22 de octubre de 2026:

• Qué se dona: el nombre y el logo de Agent Skills, la organización de GitHub y el dominio agentskills.io.
• A quién: a la Agentic AI Foundation, que vive dentro de la Linux Foundation. Anthropic la cofundó el año pasado con Block y OpenAI, y ya le había donado el Model Context Protocol (MCP).
• Quién lo mantiene: ingenieros de Anthropic, Google, OpenAI y otras empresas, a título individual. Los Lead Maintainers son David Soria Parra y Mahesh Murag.
• Qué sigue: Anthropic propuso empezar con una hoja de ruta que incluye versiones numeradas del estándar, un proceso formal de propuestas y una guía de seguridad para quienes escriben e instalan skills.
• Qué no cambia: puedes seguir usando el estándar o contribuir a él sin unirte a la AAIF.

La nota también da algunas cifras de Anthropic: más de 70 plataformas de agentes integraron Agent Skills desde que se publicó como estándar en diciembre de 2025, entre ellas ChatGPT, Cursor, GitHub Copilot y VS Code. Hasta la fecha del anuncio se habían publicado 1 millón de skills y se habían instalado casi 280 millones.

Si quieres entender MCP, el otro estándar que ahora vive en la AAIF, tengo una guía para conectar servidores MCP a Claude Code.

Qué es un skill según el estándar

La especificación define un skill como un directorio que contiene, como mínimo, un archivo SKILL.md:

nombre-del-skill/
├── SKILL.md          # Obligatorio: metadatos + instrucciones
├── scripts/          # Opcional: código ejecutable
├── references/       # Opcional: documentación
├── assets/           # Opcional: plantillas, recursos
└── ...               # Cualquier otro archivo o carpeta

SKILL.md lleva un frontmatter YAML seguido de las instrucciones en Markdown. El cuerpo no tiene restricciones de formato; la especificación recomienda incluir instrucciones paso a paso, ejemplos de entradas y salidas, y casos límite comunes.

Los agentes cargan los skills por divulgación progresiva (progressive disclosure), en tres niveles:

1. Metadatos (unos 100 tokens): al arrancar, el agente carga solo name y description de todos los skills.
2. Instrucciones (se recomiendan menos de 5000 tokens): cuando una tarea coincide con la descripción, el agente lee el SKILL.md completo.
3. Recursos (según haga falta): los archivos de scripts/, references/ o assets/ se cargan solo cuando se necesitan.

Por eso puedes tener muchos skills instalados sin llenar el contexto. Es la misma idea que expliqué en cuándo integrar subagentes en el agente principal, donde un solo agente con skills reemplaza a varios subagentes.

Los seis campos del frontmatter

La especificación solo define seis campos:

El campo name tiene además estas reglas:

• No puede tener dos guiones seguidos (--).
• Debe coincidir con el nombre de la carpeta que contiene el skill.

Y dos recomendaciones de la especificación que conviene seguir: mantener el SKILL.md por debajo de 500 líneas (lo demás va en archivos aparte) y que las referencias a otros archivos usen rutas relativas desde la raíz del skill y no pasen de un nivel de profundidad.

Ejemplo: un skill mínimo y portable

Este es un ejemplo que escribí para el artículo, no un skill oficial. Genera notas de versión a partir del historial de git y solo usa campos del estándar, así que debería cargarse en cualquier agente compatible. Va en una carpeta llamada notas-de-version, porque name tiene que coincidir con ella:

---
name: notas-de-version
description: Redacta notas de versión en español a partir de los commits desde la última etiqueta de git. Úsalo cuando el usuario pida un changelog, notas de versión o un resumen de cambios para publicar.
license: MIT
metadata:
  author: javi-mata
  version: "1.0"
---

# Notas de versión

1. Obtén la última etiqueta con `git describe --tags --abbrev=0`.
2. Lista los commits desde esa etiqueta con `git log <etiqueta>..HEAD --oneline`.
3. Agrupa los cambios en tres secciones: Nuevo, Mejoras y Correcciones.
4. Escribe cada punto en una línea, en lenguaje para usuarios, sin hashes de commit.
5. Si no hay etiquetas, pregunta desde qué commit empezar.

Para el formato final, sigue la plantilla de [references/plantilla.md](references/plantilla.md).

Fíjate en la description: dice qué hace y cuándo usarlo, con las palabras que el usuario probablemente escribirá. La especificación pone como mal ejemplo algo como description: Helps with PDFs., porque no le da al agente pistas para saber cuándo activarlo.

Lo que Claude Code añade al estándar

La documentación de Claude Code dice que sus skills siguen el estándar abierto Agent Skills y lo amplían con funciones propias: control de quién invoca el skill, ejecución en un subagente e inyección de contexto dinámico.

Esos extras se configuran con campos de frontmatter que no están en el estándar, por ejemplo:

• disable-model-invocation y user-invocable, para decidir si el skill lo lanza Claude, tú o los dos.
• context: fork y agent, para ejecutarlo en un subagente.
• paths, para que solo se active con ciertos archivos.
• model, effort, hooks, argument-hint, arguments, when_to_use, entre otros.

En cómo crear un skill en Claude Code tienes un ejemplo completo con los campos más usados.

Dónde funciona cada campo

La documentación de Claude Code lo resume así:

Esto importa por un detalle: Claude Code ignora sin avisar un campo que no reconoce, pero al subir un skill a claude.ai o empaquetarlo, un campo fuera del estándar provoca un error en lugar de ignorarse:

Unexpected key(s) in SKILL.md frontmatter: argument-hint. Allowed properties are: allowed-tools, compatibility, description, license, metadata, name

Hay otras diferencias que conviene conocer:

• name es opcional en Claude Code (si falta, usa el nombre de la carpeta), pero es obligatorio en el estándar. Para que tu skill sea portable, escríbelo siempre y haz que coincida con la carpeta.
• Si falta description, Claude Code usa la primera línea no vacía del contenido; el estándar la exige.
• Claude Code acepta license, compatibility y metadata, pero no hace nada con ellos.
• Funciones del cuerpo exclusivas de Claude Code, como la inyección de contexto dinámico, no funcionan en claude.ai ni en la API.
• allowed-tools es experimental en el estándar y su soporte varía entre agentes.

Mi recomendación

Si un skill es solo para ti y solo lo usas en Claude Code, usa todos los campos que te sirvan. Si lo vas a compartir con tu equipo, publicar en un repositorio o subir a claude.ai, limita el frontmatter a los seis campos del estándar y escribe name aunque Claude Code no lo pida. Así el mismo skill te sirve en cualquier agente compatible.

Valida tu skill con skills-ref

La especificación remite a skills-ref, la librería de referencia que está en el repositorio del estándar, para comprobar que el frontmatter es válido y cumple las reglas de nombres. Su README aclara que es solo para demostración y no está pensada para producción, así que úsala como verificación, no como dependencia de tu proyecto.

Según el README, se instala dentro de la carpeta skills-ref del repositorio con un entorno virtual de Python:

git clone https://github.com/agentskills/agentskills.git
cd agentskills/skills-ref
python -m venv .venv
source .venv/bin/activate
pip install -e .

Con el entorno activado tienes el comando skills-ref:

# Validar un skill
skills-ref validate ruta/al/skill

# Leer sus propiedades (devuelve JSON)
skills-ref read-properties ruta/al/skill

# Generar el bloque <available_skills> para el prompt de un agente
skills-ref to-prompt ruta/al/skill-a ruta/al/skill-b

El último comando es útil si estás construyendo tu propio agente: genera el bloque XML con el nombre, la descripción y la ubicación de cada skill, que según el README es el formato recomendado para los modelos de Anthropic.

Mi lectura

Para quien escribe skills en Claude Code, la donación no cambia nada en el día a día: tus carpetas y tus SKILL.md siguen funcionando igual. Lo que cambia es la confianza en el formato. Con MCP y Agent Skills en la misma fundación y con mantenedores de varias empresas, es razonable asumir que escribir skills según el estándar es una buena inversión, porque no dependen de una sola herramienta.

Lo que sí haría ahora es revisar los skills que compartes, quitarles los campos exclusivos de Claude Code si no los necesitas y pasarlos por skills-ref validate. Y estar atento a la hoja de ruta: las versiones numeradas del estándar y la guía de seguridad para instalar skills de terceros todavía son una propuesta.

Fuentes

• Donating Agent Skills to the Agentic AI Foundation (Anthropic, 22 de octubre de 2026)
• Agent Skills: Overview
• Agent Skills: Specification
• Repositorio agentskills/agentskills en GitHub
• README de skills-ref
• Extend Claude with skills (documentación de Claude Code)