Cómo funciona
El protocolo Agent Skills define un ciclo de vida simple para cómo los agentes interactúan con las habilidades:
1. Descubrimiento (Discovery)
Al inicio, los agentes cargan solo los metadatos ligeros (nombre y descripción) de cada habilidad disponible. Esto mantiene la ventana de contexto limpia y eficiente.
2. Activación (Activation)
Cuando la solicitud de un usuario coincide con la descripción de una habilidad, el agente la "activa" leyendo el conjunto completo de instrucciones del archivo de definición de la habilidad.
3. Ejecución (Execution)
El agente sigue las instrucciones paso a paso proporcionadas por la habilidad, que pueden implicar ejecutar código, procesar archivos o llamar a API externas.
Estructura de Directorio
Las habilidades se organizan en una estructura de directorio simple. Cada habilidad vive en su propia carpeta y requiere un archivo `SKILL.md` correcto.
skill-name/
└── SKILL.md # Required: The main definition file
└── scripts/ # Optional: Helper scripts (Python, Node, etc.)
└── references/ # Optional: Text files for RAG
└── assets/ # Optional: Images or templatesEl Estándar SKILL.md
En el corazón de cada habilidad hay un archivo `SKILL.md`. Combina YAML frontmatter para metadatos con Markdown legible por humanos para instrucciones. Este formato de "Doble Audiencia" sirve tanto al agente de IA como a los desarrolladores humanos.
---
name: pdf-processing
description: Extract text and tables from PDF files.
---
# PDF Processing
## When to use this skill
Use this skill when the user needs to work with PDF files...
## How to extract text
1. Use `pdfplumber` for text extraction...¿Por qué usar Agent Skills?
Autodocumentado
Las instrucciones para el agente SON la documentación para el desarrollador.
Portátil
Las habilidades son solo archivos. Son fáciles de controlar versiones, compartir y editar.
Universal
Funciona con cualquier LLM y cualquier marco de agente que admita la especificación.
Seguro
Ejecución en entorno aislado (sandbox) y ámbitos de permisos explícitos.
Empieza a Explorar
¿Listo para ver qué es posible? Navega por el mercado para descubrir cientos de habilidades contribuidas por la comunidad.