Habilidad de agente (SKILL.md)
Un paquete de capacidad reutilizable que convierte conocimiento tácito en procedimiento inspeccionable. No es un prompt: es un directorio con estructura fija.
Las herramientas dan manos a los agentes. Las habilidades les enseñan un oficio.
Dónde encaja
La capacidad de un agente se construye por capas, y las habilidades ocupan el hueco intermedio que faltaba:
| Capa | Pregunta que responde |
|---|---|
| Modelo | Razonamiento general |
| Agente | ¿Quién decide? — metas y decisiones |
| Habilidad | ¿Cómo se trabaja? — formas de trabajar |
| Herramienta | ¿Qué puede actuar? — acciones ejecutables |
| Entorno | Sistemas y datos |
La estructura
| Elemento | Contenido |
|---|---|
SKILL.md |
Punto de entrada: instrucciones de flujo y reglas de decisión |
references/ |
Políticas y conocimiento especializado |
scripts/ |
Cómputo determinista |
assets/ |
Plantillas y ejemplos |
| Herramientas | Acción externa y datos en vivo |
Descubrimiento y ejecución, separados
El name y la description del encabezado deciden si la habilidad se selecciona; el cuerpo controla el flujo una vez activada.
Qué cambia frente a promptear cada vez
| Sin habilidad | Con habilidad |
|---|---|
| Volver a promptear → el procedimiento se desvía | Reutilizable — el mismo método en todas las tareas |
| Prompts de sistema larguísimos → el contexto se satura | Inspeccionable — una persona puede revisar el procedimiento |
| Proceso local oculto → no se puede auditar | Versionable — el cambio sigue el proceso |
| Pasos críticos olvidados → validación frágil | Comprobable — activación y salidas se pueden evaluar |
Divulgación progresiva
El modelo no carga todos los procedimientos en cada interacción: primero ve solo los metadatos (nombre, descripción, ruta), luego el SKILL.md completo cuando la tarea encaja con la descripción, y por último solo los recursos que necesita.
Descubrimiento compacto → instrucción completa → recursos selectivos.
Activación explícita o implícita
| Explícita | Implícita |
|---|---|
| Una persona u orquestador nombra la habilidad | El modelo empareja la tarea con la descripción |
| Para flujos obligatorios, habilidades solapadas, auditabilidad y previsibilidad | Para descubrimiento natural, ensamblaje dinámico, trabajo de bajo riesgo y reversión fácil |
Vocabulario que se confunde
| Concepto | Pregunta | Ejemplo |
|---|---|---|
| Prompt | ¿Qué se quiere ahora? | Revisa este contrato |
| Agente | ¿Quién es responsable? | Agente de revisión de contratos |
| Habilidad | ¿Cómo debe transcurrir el trabajo? | El procedimiento de revisión |
| Herramienta | ¿Qué acción puede ejecutarse? | Leer archivo, consultar base de datos |
| Contexto | ¿Qué se sabe ahora? | El contrato y la conversación |
| Guardarraíl | ¿Qué debe imponerse? | Bloquear una aprobación no autorizada |
En el curso
No aparece en ningún módulo. Lo introduce el Welcome Webinar de John Williams y Abel Sanchez, con dos ejemplos —contract-review y code-tour— y la demostración en directo de una habilidad colocada en .agents/skills/<nombre>/SKILL.md.
En un sistema multiagente, los agentes reparten la responsabilidad y las habilidades estandarizan la ejecución.
Relacionado
Agente de IA · Desarrollo dirigido por especificación (SDD) · Harness engineering · Ventana de contexto · Arquitectura de múltiples agentes
Enlaces entrantes
- Curso IA Agéntica (MOC)Índice
- Webinars de facultadSesión