Conceptos Básicos

What are Agent Skills?

Capacidades modulares que permiten a los agentes de IA interactuar con el mundo de forma fiable y segura.

Agent Skills es un formato simple y abierto para dar a los agentes de IA nuevas capacidades y experiencia. Son como guías de incorporación para nuevos empleados: empaquetan conocimiento procedimental, contexto organizacional y mejores prácticas en recursos modulares que los agentes pueden descubrir y cargar dinámicamente.

Unidades Funcionales

Las habilidades son paquetes de código autónomos (Prompt + Herramienta) que otorgan a un agente una capacidad específica, como 'Buscar en la web' o 'Enviar correo electrónico'.

Descubrible

Diseñado con metadatos estándar para que los agentes puedan 'aprender' o 'cargar' dinámicamente cuando un usuario solicita una tarea relacionada.

Estandarizado

Sigue una estructura de archivos común (SKILL.md, scripts/) asegurando la compatibilidad entre diferentes marcos de agentes.

¿Qué pueden hacer las Agent Skills?

Experiencia de Dominio

Empaqueta conocimiento especializado en instrucciones reutilizables, desde procesos de revisión legal hasta pipelines de análisis de datos.

Nuevas Capacidades

Da a los agentes nuevas capacidades (ej. crear presentaciones, construir servidores MCP, analizar conjuntos de datos).

Flujos de Trabajo Repetibles

Convierte tareas de múltiples pasos en flujos de trabajo consistentes y auditables.

Interoperabilidad

Reutiliza la misma habilidad en diferentes productos de agentes compatibles con skills.

Divulgación Progresiva: El Principio de Diseño Central

Las habilidades usan divulgación progresiva, como un manual bien organizado que comienza con una tabla de contenidos, luego capítulos específicos y finalmente un apéndice detallado. Los agentes cargan información solo cuando es necesario, gestionando eficazmente la ventana de contexto.

Nivel 1: Metadatos

Al inicio, el agente precarga el nombre y descripción de cada habilidad instalada en su prompt del sistema. Esto proporciona suficiente información para que el agente sepa cuándo debe usar cada habilidad sin cargar todo.

Nivel 2: SKILL.md

Si el agente cree que la habilidad es relevante para la tarea actual, cargará la habilidad leyendo su SKILL.md completo en contexto. Este es el segundo nivel de detalle.

Nivel 3+: Archivos de Referencia

A medida que las habilidades crecen en complejidad, pueden contener demasiado contexto para caber en un solo SKILL.md. En estos casos, las habilidades pueden incluir archivos adicionales dentro del directorio de habilidades, que el agente puede elegir navegar y descubrir solo cuando sea necesario.

Anatomía de una Habilidad

Cada habilidad sigue una estructura rigurosa para garantizar la previsibilidad del LLM. No es solo código; es una interfaz semántica.

  • Archivo de Definición (SKILL.md)
  • Scripts Python/Node.js
  • Directorio de Activos
  • Registro de Metadatos
my-awesome-skill/
├── SKILL.md
├── scripts/
│   ├── browser_tool.py
│   └── util.py
├── assets/
└── references/

Mejores Prácticas de Creación de Habilidades

Hacer
  • Mantenerlo conciso - la ventana de contexto es un bien público
  • Usar patrones de divulgación progresiva
  • Proporcionar flujos de trabajo claros para tareas complejas
  • Implementar bucles de retroalimentación y pasos de validación
  • Usar terminología consistente
No Hacer
  • Evitar referencias profundamente anidadas
  • No incluir información sensible al tiempo
  • No ofrecer demasiadas opciones
  • Evitar asumir que las herramientas están instaladas
  • No usar rutas de estilo Windows

Principio Central: Lo Conciso es Clave

La ventana de contexto es un bien público. Tu Habilidad comparte la ventana de contexto con todo lo demás que el agente necesita saber, incluido el prompt del sistema, historial de conversación, metadatos de otras Habilidades y tu solicitud real. Suposición predeterminada: Claude ya es muy inteligente, solo agrega contexto que Claude aún no tiene.

Plataformas Compatibles

Instala habilidades en tu framework de agentes favorito.

¿Listo para construir?

Consulte la documentación oficial o explore las habilidades existentes para inspirarse.

Referencias