Agent Skills: qué son, qué lleva un SKILL.md y cuándo usar MCP

Las Agent Skills son un formato abierto para darle a un agente conocimiento procedimental. Cada skill es una carpeta con un archivo SKILL.md que explica cómo hacer una tarea concreta, y el agente solo la carga cuando la necesita. MCP le da al agente acceso a herramientas y datos, y una skill le dice cómo usarlos para un trabajo determinado (especificación de Agent Skills).

Si llegaste buscando “Claude Skills”, es el mismo formato: lo creó Anthropic y lo publicó como estándar abierto. En este artículo verás qué hay dentro de una skill, quién la soporta y qué ha cambiado entre agosto y octubre de 2026 y, sobre todo, cuándo te conviene una skill, un servidor MCP o un AGENTS.md. Los tres resuelven problemas distintos y se combinan bien.

Qué es una skill

Una skill es una carpeta. Lo único obligatorio es el archivo SKILL.md, que lleva un frontmatter YAML con name y description como mínimo y, debajo, las instrucciones en Markdown. Junto a él pueden ir tres carpetas opcionales: scripts/, references/ y assets/ (especificación).

Lo que hace útil al formato es la divulgación progresiva (progressive disclosure). El agente no mete todas las skills en el contexto de golpe, sino que las carga en tres escalones.

1. Metadatos. Al arrancar, el agente solo ve el nombre y la descripción de cada skill, unos 100 tokens por skill.
2. Cuerpo. Cuando decide que una skill aplica a la tarea, carga el cuerpo del SKILL.md. La especificación recomienda que no pase de 5.000 tokens.
3. Recursos. Los archivos de scripts/, references/ o assets/ se leen solo si hacen falta.

La consecuencia práctica es que puedes tener decenas de skills instaladas sin pagar su coste de contexto hasta que una se activa. Por eso conviene cuidar la description. Es lo único que el agente lee para decidir si la skill viene al caso, así que tiene que decir qué hace la skill y cuándo usarla.

El formato mínimo

Este es el SKILL.md más pequeño que admite la especificación (ejemplo literal de agentskills.io/specification):

---
name: skill-name
description: A description of what this skill does and when to use it.
---

Aparte de los dos campos obligatorios, la especificación define tres opcionales: license, compatibility y metadata. Hay un cuarto, allowed-tools, también opcional y además experimental. La especificación en sí no tiene número de versión (especificación).

La propia web explica quién la mantiene: “The Agent Skills format was originally developed by Anthropic, released as an open standard, and has been adopted by a growing number of agent products. The standard is open to contributions from the broader ecosystem” (agentskills.io). El desarrollo se coordina en Discord y en el repositorio agentskills/agentskills, que a 3 de octubre de 2026 tiene unas 25.900 estrellas. A diferencia de MCP o AGENTS.md, Agent Skills no figura en la lista de proyectos de la Agentic AI Foundation.

Quién lo usa

El escaparate oficial de clientes enumera unos 47 productos. Entre ellos están Claude y Claude Code, ChatGPT & Codex, GitHub Copilot, VS Code, Cursor, Gemini CLI, Goose, Junie (JetBrains), OpenCode, OpenHands, Kiro, Snowflake Cortex Code, Databricks Genie Code, Spring AI, Mistral Vibe, Tabnine, Pulumi Neo, Hermes Agent y OpenClaw (agentskills.io).

En la práctica, una skill bien escrita no te ata a un cliente concreto. El mismo SKILL.md lo pueden leer agentes de varios fabricantes.

Qué ha cambiado entre agosto y octubre de 2026

El formato en sí apenas se ha movido. Lo que ha cambiado es el soporte alrededor, sobre todo en la plataforma de Claude y en MCP.

Fecha	Novedad	Fuente
3 y 4 de agosto	Se aclara el campo metadata en la especificación (PR #479) y se actualiza la marca “ChatGPT & Codex” en el escaparate	commits de agentskills
7 de agosto	Claude Managed Agents carga skills automáticamente desde .claude/skills de un repositorio de GitHub montado	release notes de Claude
9 de agosto	Hermes Agent (Nous Research) y OpenClaw entran en el escaparate oficial	commits de agentskills
19 de agosto	Agent Skills y la Skills API (/v1/skills) salen de beta en la API de Claude: ya no hace falta la cabecera skills-2025-10-02	release notes de Claude
27 de agosto	Los SDK de Anthropic alinean client.beta.skills con client.skills, y BetaSkill pasa a llamarse BetaContainerSkill	release notes de Claude
3 de septiembre	ant apply (CLI ant 1.30.0) crea y actualiza skills, agentes y otros recursos desde archivos del repositorio	release notes de Claude
13 de septiembre	La extensión Skills de MCP (SEP-2640) pasa a Final	PR #2640

Si usas la API de Claude y tenías la cabecera beta en tu código, el cambio del 19 de agosto te permite quitarla. Si usas los SDK de Anthropic, revisa el cambio de nombres del 27 de agosto antes de actualizar.

Cómo se conectan las skills con MCP

Desde el 13 de septiembre de 2026, MCP tiene una extensión oficial para servirlas desde un servidor: io.modelcontextprotocol/skills, definida en la SEP-2640.

Para entender la relación, fíjate en el reparto de papeles. La extensión define solo el transporte. El servidor expone cada archivo de la skill como recurso MCP, normalmente bajo el esquema skill://, e implementa skills/list y skills/get. El formato, en cambio, “is delegated entirely to the Agent Skills specification; this SEP defines only the transport binding” (SEP-2640). Es decir, el SKILL.md que sirve un servidor MCP es el mismo que tendrías en una carpeta local.

La extensión aporta también una garantía que la carpeta local no tiene. Cada entrada de skills/list lleva digests SHA-256 por archivo, y el host debe verificarlos. La aprobación del usuario queda ligada al conjunto exacto de recursos: si ese conjunto cambia, la aprobación se revoca (SEP-2640).

El soporte todavía es corto. La matriz oficial marca soporte completo en mcpc (Apify) y parcial en ChatGPT, fast-agent y MCP Inspector (matriz de extensiones). La documentación de la extensión también avisa de que “SDK and host support is still being implemented” (Skills extension overview). Los mensajes, la verificación de digests y qué clientes la soportan los tienes en el artículo sobre la extensión Skills de MCP.

Hay otra forma de combinar skills y MCP que no pasa por el protocolo: el empaquetado. El 6 de agosto Vercel publicó Agent Plugins 1.0.0, un formato abierto que reúne en un mismo plugin un plugin.json, una carpeta skills/ y un mcp.json. Vercel lo acordó con AWS, Anysphere, GitHub, Microsoft y OpenAI, y desde el lanzamiento lo soportan ChatGPT, Codex, Cursor, GitHub Copilot, Kiro y VS Code. Anthropic no aparece entre los firmantes (Vercel).

Skills, MCP y AGENTS.md: en qué se diferencian

El tercer elemento de la comparación es AGENTS.md. La web oficial lo define como “a simple, open format for guiding coding agents”: un archivo Markdown en el repositorio con instrucciones para los agentes de código (agents.md). Es proyecto alojado de la Agentic AI Foundation desde su fundación (AAIF).

Según su web, lo usan más de 60.000 proyectos de código abierto y más de 25 herramientas, entre ellas Codex, Jules, Cursor, Aider, VS Code, GitHub Copilot y Junie. Son cifras que declara el propio proyecto (agents.md). En el periodo solo consta una novedad: un Technical Charter añadido al repositorio el 10 de septiembre de 2026 (commits de agents.md).

Así empieza el ejemplo de la web (fragmento literal de agents.md):

# Sample AGENTS.md file 
## Dev environment tips
- Use `pnpm dlx turbo run where <project_name>` to jump to a package instead of scanning with `ls`.
- Run `pnpm install --filter <project_name>` to add the package to your workspace so Vite, ESLint, and TypeScript can see it.

Esta tabla resume las tres piezas:

	Agent Skills	MCP	AGENTS.md
Qué aporta	Cómo hacer una tarea: procedimiento, convenciones, scripts de apoyo	Acceso a herramientas, datos y prompts de otros sistemas	Instrucciones fijas para trabajar en un repositorio
Cuándo entra en el contexto	Bajo demanda, en tres escalones	Cuando el agente lista o invoca herramientas y recursos	Siempre que el agente trabaja en ese repositorio
Dónde vive	Una carpeta con SKILL.md, local o servida por MCP	Un servidor, local o remoto	Un archivo en el repositorio
Ejecuta acciones	No por sí misma; puede traer scripts en scripts/	Sí, a través de las tools del servidor	No
Gobernanza	Creado por Anthropic, abierto a contribuciones en GitHub	Agentic AI Foundation	Agentic AI Foundation

La diferencia entre skills y AGENTS.md es la que más confunde, porque los dos son Markdown con instrucciones. Lo que los separa es cuándo se cargan. AGENTS.md es contexto fijo del repositorio, y una skill se carga solo cuando hace falta (agents.md, especificación de Agent Skills).

Cuándo usar cada uno

Lo que sigue es un criterio, no una norma. Parte de una pregunta: ¿qué le falta al agente para hacer bien la tarea?

Le falta acceso: usa MCP. Si el agente necesita leer un pedido de tu base de datos, crear un ticket o consultar existencias en otro sistema, ninguna cantidad de instrucciones lo resuelve. Hace falta un servidor que exponga esas acciones como tools, con su autenticación y sus permisos. Una skill no sustituye a un servidor MCP.

Le falta saber hacerlo: usa una skill. Si el agente ya tiene las herramientas pero no conoce tu procedimiento, eso es conocimiento procedimental: en qué orden se hacen las cosas, qué comprobaciones exige tu equipo, qué plantilla usar. Escríbelo en una skill con una description precisa y deja que el agente la cargue solo cuando la tarea lo pida. La skill es especialmente útil cuando ese procedimiento solo aplica a una parte del trabajo, porque en AGENTS.md ocuparía contexto en todas las sesiones.

Le falta contexto del proyecto: usa AGENTS.md. Aquí entran los comandos de build y test, la estructura del monorepo y las convenciones de estilo que aplican a todo el código. El agente necesita esa información siempre que trabaja en ese repositorio, así que no gana nada cargándola bajo demanda.

Muchas veces necesitas los tres. Piensa en un caso típico. Un servidor MCP expone emitir_abono. Una skill explica el procedimiento de abonos de tu empresa, es decir, qué validar antes y cuándo pedir aprobación. El AGENTS.md del repositorio del servidor dice cómo se ejecutan sus tests. Cada pieza hace una cosa y no duplica a las demás.

Dos señales de que estás usando la pieza equivocada:

• Tu AGENTS.md crece con secciones que solo aplican a una tarea concreta. Esas secciones son candidatas a skill.
• Una skill describe cómo llamar a una API con curl y credenciales a mano. Eso es acceso, y estaría mejor detrás de un servidor MCP con autorización propia.

Si mantienes un servidor MCP y quieres distribuir con él las skills que explican cómo usar sus tools, el camino previsto es la extensión io.modelcontextprotocol/skills. Ten en cuenta que el soporte en clientes todavía es parcial. Si lo que quieres es empaquetar servidor y skills juntos para los clientes que lo soportan, la alternativa es Agent Plugins.

Para seguir

El curso de MCP trabaja el papel de MCP como capa de acceso y cómo un agente con Claude orquesta varios servidores. Lo verás en las lecciones de agentes con MCP y de beneficios y desafíos de adoptarlo.

Si quieres ver dónde encajan las skills en el resto de la pila (A2A, AG-UI, pagos, llms.txt), el mapa de protocolos de agentes de IA lo recorre capa por capa. La comparativa A2A frente a MCP cubre la parte de comunicación entre agentes.

Y si vas a servir skills desde tu propio servidor MCP, tools, resources y skills en MCP explica qué va en cada pieza.