Agent Skills: en qué se diferencian de los prompts, los MCP y los subagentes

Tienes una carpeta con prompts que copias y pegas. Tienes un agents.md en cada proyecto. Puede que hasta hayas conectado un MCP o dos. Y de repente todo el mundo habla de skills, y tú piensas: “otra mandanga más, si yo ya tengo mis prompts”.

Lo pensé yo también. Y es justo esa frase —“si ya tengo mis prompts”— la que te impide verlo. Porque una Agent Skill no es un prompt guardado, ni tu agents.md, ni un MCP, ni un subagente. Se parece a todos ellos lo justo para que los confundas, y mientras los confundes no le sacas partido.

Así que no vengo a enseñarte a crear una (eso es otra historia). Vengo a quitarte las confusiones de encima y a dejarte claro cuándo tirar de cada cosa. Vamos.

Una skill no es un prompt que guardas ¶

Un prompt lo tecleas o lo pegas, y entra entero en la conversación cada vez. Una skill es otra cosa: es un fichero markdown con instrucciones claras que el agente solo carga si entiende que lo necesita.

Eso es la carga progresiva (progressive disclosure), y es la diferencia que lo cambia todo. La skill tiene tres niveles: primero solo su metadata —el name y la description, unos 100 tokens— viviendo en la memoria del modelo ocupando casi nada; si la petición lo justifica, el agente lee el cuerpo completo de instrucciones; y solo si hace falta, va a buscar ficheros de recursos concretos. Un prompt no sabe hacer eso: o está, o no está, y si está, pesa.

Además las skills se apilan (composable): una puede acompañar a otra. Tus prompts no se componen, se amontonan.

Cuándo usar cada uno: la primera regla de la productividad, que es anterior a la IA, dice que si haces algo dos veces lo conviertas en algo reutilizable. Si te descubres subiendo con la flecha del cursor para recuperar el mismo prompt y cambiarle un parámetro, eso ya no es un prompt: es una skill esperando a nacer. Deja en el prompt lo puntual del momento; mete en la skill lo que repites.

Una skill no es tu agents.md (ni tu CLAUDE.md) ¶

El fichero fundacional —ese agents.md o CLAUDE.md que aparece cuando lanzas /init— es un briefing del repositorio: el contexto, las reglas, qué framework usas, cómo se trabaja aquí. Su gracia es que cualquier agente que entre al proyecto lo lea lo primero y arranque con esa memoria básica sin tener que leerse el código entero.

La skill nace con la voluntad contraria: ser portable. Está pensada para que la muevas de un proyecto a otro sin depender del contexto de ninguno.

Cuándo usar cada uno: el agents.md es para “cómo es ESTE proyecto”. La skill es para “una habilidad que quiero tener en TODOS”: generar el texto de una pull request, hacer una revisión de seguridad en cualquier proyecto de TypeScript, crear un módulo siguiendo tu plantilla. Lo que vive con el repo, al fundacional; lo que viaja contigo, a una skill.

Una skill no es un MCP ni un subagente ¶

Aquí se juntan las dos confusiones más caras.

Un MCP (Model Context Protocol) conecta la IA con la realidad: el tiempo que va a hacer hoy, cómo está montada tu base de datos, una multiplicación que no se invente. El problema es que cada herramienta que añade un MCP se come parte de tu ventana de contexto —el MCP de Chrome DevTools trae quince o veinte tools, una por cada clic o scroll—, así que en economía de tokens es justo lo contrario de barato. La skill, en cambio, pesa esos ~100 tokens hasta que se usa, y desde dentro de ella puedes pedirle que ejecute el MCP cuando de verdad toca. Por eso las skills vienen, en parte, a aliviar a los MCP.

Un subagente es otra cosa distinta: tiene su propia ventana de contexto, su system prompt, sus herramientas permitidas, y puede correr en paralelo con otros. Es casi un clon del agente principal con una tarea dirigida. La skill no abre ningún proceso aparte: es una habilidad que inyectas en tu propia conversación.

Cuándo usar cada uno: MCP cuando necesitas datos o acciones del mundo real. Subagente cuando quieres paralelismo o aislar una tarea en su propio contexto. Skill cuando quieres encapsular un “cómo hago X” repetible y portable. Y por encima de todos, el plugin (o extensión), que es el paquete grande que puede llevar dentro skills, agentes y MCP a la vez.

Con esto ya no deberías confundir una skill con lo que ya tenías, y sabes cuándo tirar de cada herramienta. Lo que me he callado es lo más divertido: cómo crear una skill de verdad —sin escribir una sola línea— y cómo sacar skills nuevas de tu propio proyecto.