Agent Skills
Por qué importa
Los modelos de propósito general son capaces, pero no conocen tus procedimientos: cómo da formato tu equipo a los informes, qué pasos necesita tu despliegue, cómo llenar un formulario PDF en particular. Poner todo eso en el prompt de sistema no escala, porque cada instrucción cuesta contexto en cada solicitud, sea relevante o no.
Las skills lo resuelven con divulgación progresiva. Al principio el agente solo ve el nombre y la descripción de cada skill, unos 100 tokens por cada una. Cuando una tarea coincide, lee el SKILL.md completo. Si esas instrucciones mencionan otro archivo, lo abre solo si hace falta. Un agente puede tener cientos de skills instaladas y no pagar casi nada hasta que usa una.
En profundidad
Una skill de agente es una carpeta que le enseña a un agente de IA cómo hacer un tipo específico de tarea. En su centro hay un archivo, SKILL.md, que empieza con un encabezado YAML corto (un nombre y una descripción) seguido de instrucciones en Markdown simple. La carpeta también puede contener scripts, plantillas y documentos de referencia a los que apuntan las instrucciones.
Anthropic presentó las Agent Skills para Claude en octubre de 2025 y publicó el formato como estándar abierto en diciembre de 2025. Desde entonces lo han adoptado otras herramientas de agentes, entre ellas Codex de OpenAI, GitHub Copilot, Cursor y Gemini CLI, así que la misma carpeta de skill puede funcionar en distintos productos.
Anatomía de una skill
pdf-forms/
├── SKILL.md # name, description, instructions
├── reference.md # extra detail, read only if needed
└── scripts/
└── fill_form.py # code the agent can run
El encabezado al inicio de SKILL.md tiene dos campos obligatorios:
name: pdf-forms
description: Fill in PDF forms. Use when the user asks to complete or extract fields from a PDF form.
La descripción es la línea más importante. Es todo lo que el modelo ve cuando decide si carga la skill, así que debe decir tanto qué hace la skill como cuándo usarla.
Código incluido
Las skills pueden incluir scripts. Esto importa porque algunas cosas se hacen mejor con código que generando tokens: ordenar una hoja de cálculo, extraer los campos de un formulario, validar una salida. El agente ejecuta el script y solo ve el resultado, así que el código en sí nunca ocupa contexto. Por eso también las skills necesitan un entorno con sistema de archivos y ejecución de código, como un agente de codificación o un contenedor aislado (sandbox).
Skills, MCP y prompts
- MCP conecta a un agente con herramientas y datos externos: tu base de datos, tu sistema de tickets. Le da al agente nuevas capacidades.
- Las skills le enseñan al agente cómo hacer algo con las capacidades que ya tiene. Una skill puede incluso describir cómo usar bien un servidor MCP en particular.
- Los prompts de sistema y los archivos de instrucciones del proyecto (como
CLAUDE.mdoAGENTS.md) se cargan siempre. Sirven para reglas que aplican todo el tiempo, mientras que las skills sirven para conocimiento que solo se necesita a veces.
Cómo escribir buenas skills
Parte de fallos reales: observa dónde le cuesta al agente una tarea y luego anota lo que le faltaba. Mantén SKILL.md corto y mueve los detalles a archivos separados. Escribe para un recién llegado inteligente: explica lo que no es obvio y omite lo que el modelo ya sabe. Prueba tanto que la skill se active cuando debe como que se quede callada cuando no debe.
Seguridad
Una skill es instrucciones más código ejecutable, que corre con todo el acceso que tenga el agente. Una skill maliciosa puede decirle al agente que filtre datos o ejecute comandos dañinos, lo que la convierte en una prompt injection entregada como plugin. Instala skills solo de fuentes en las que confíes, y lee lo que contienen antes de habilitarlas, sobre todo los scripts y cualquier cosa que llame a la red.