Agent Skills

Las habilidades de agentes son paquetes reutilizables de instrucciones, metadatos, materiales de referencia y scripts opcionales que proporcionan conocimientos especializados a un agente de IA para una tarea concreta. En lugar de incluir todos los procedimientos en un prompt de sistema largo, los desarrolladores pueden empaquetar una capacidad específica —como inspeccionar productos, analizar hojas de cálculo o seguir la lista de comprobación de despliegue de una organización— y permitir que el agente la cargue solo cuando sea relevante.

Las habilidades ayudan a un agente de IA de propósito general a comportarse más como un especialista del dominio, al tiempo que mantienen el conocimiento modular, fácil de mantener y portable. “Claude Skills” es una implementación de producto de esta idea más amplia; el término Habilidades de agentes también puede referirse al formato interoperable descrito en la descripción general de Agent Skills abierta.

Cómo funcionan las habilidades de agentes#

Según la especificación de Agent Skills, una habilidad suele ser un directorio que contiene un archivo SKILL.md obligatorio. Este archivo comienza con metadatos YAML, incluidos un nombre y una descripción que explican qué hace la habilidad y cuándo debe activarla el agente. Su cuerpo en Markdown proporciona procedimientos, ejemplos, restricciones y orientación para casos extremos. Los directorios opcionales pueden contener scripts ejecutables, documentos de referencia, esquemas o plantillas.

Las habilidades utilizan la divulgación progresiva, lo que significa que la información entra por etapas en la ventana de contexto del agente:

1. Inicialmente, el agente ve nombres y descripciones breves de las habilidades disponibles.
2. Cuando una solicitud coincide con una descripción, carga el SKILL.md relevante.
3. Lee los recursos de apoyo o ejecuta los scripts incluidos solo cuando es necesario.

Esto reduce el uso innecesario de tokens y permite que un agente acceda a muchas capacidades especializadas sin cargar todas las instrucciones al iniciarse. La documentación de Claude Agent Skills y la documentación de Microsoft Agent Skills proporcionan ejemplos de este patrón de carga en plataformas de agentes.

Habilidades de agentes frente a conceptos relacionados#

Las habilidades de agentes organizan conocimientos y procedimientos, pero no sustituyen al agente, sus herramientas ni el sistema que coordina sus acciones.

• Herramientas y llamadas a funciones: Una herramienta realiza una operación individual, como consultar una API o ejecutar inferencias. Una habilidad explica cuándo y cómo utilizar una o varias herramientas conjuntamente, incluidas las reglas de validación y el contexto del dominio.

• Flujos de trabajo agénticos: Una habilidad permite que el agente interprete las instrucciones de forma adaptativa. Un flujo de trabajo define una ruta de ejecución más explícita, por lo que resulta preferible para procesos de larga duración, puntos de control, aprobaciones y acciones que deben producirse en un orden fijo.

• Protocolo de contexto de modelos: MCP estandariza cómo los agentes descubren y utilizan recursos y herramientas externos. La especificación oficial de herramientas de MCP define las interfaces de las herramientas, mientras que una habilidad empaqueta conocimientos procedimentales que pueden indicar al agente que utilice esas interfaces.

Un prompt suele estar escrito para una sola conversación. Una habilidad está pensada para reutilizarse, versionarse, probarse y compartirse en entornos compatibles.

Aplicaciones en visión artificial#

Las habilidades de agentes son especialmente útiles cuando la percepción visual debe combinarse con reglas de negocio y acciones posteriores.

Inspección de fabricación: Una habilidad de control de calidad puede indicar a un agente que capture una imagen, ejecute la detección de objetos, compare las detecciones con los criterios de aceptación, guarde pruebas y solicite una revisión humana cuando la confianza sea baja. El modelo de visión proporciona las observaciones, mientras que la habilidad proporciona el procedimiento de inspección específico de la fábrica. Esto permite utilizar flujos de trabajo repetibles de detección de defectos sin incorporar todas las políticas en el prompt base del agente.

Auditoría de inventario minorista: Una habilidad de auditoría de estanterías puede guiar a un agente para procesar imágenes de tiendas, contar productos concretos, comparar los resultados con los registros de inventario y preparar una recomendación de reposición. Los equipos pueden utilizar Ultralytics Platform para anotar datos de estanterías, entrenar un modelo personalizado, desplegarlo y supervisar la herramienta visual que utiliza la habilidad.

En ambos casos, las habilidades conectan la percepción con el conocimiento operativo. No mejoran por sí solas la precisión visual del modelo subyacente; facilitan la aplicación coherente de sus resultados.

Script de visión de ejemplo para una habilidad#

Una habilidad puede incluir un script determinista para la inspección visual. El siguiente flujo de trabajo documentado de predicción de Ultralytics YOLO podría almacenarse en el directorio scripts/ de una habilidad:

from pathlib import Path

from ultralytics import YOLO

image_url = "https://ultralytics.com/images/bus.jpg"
output_path = Path("inspection_result.jpg")

# Run the skill's visual perception step
model = YOLO("yolo26n.pt")
results = model(image_url)

result = results[0]
result.save(filename=str(output_path))

print(output_path)

Aquí, YOLO26 proporciona la capacidad visual, mientras que SKILL.md explicaría cuándo ejecutar el script, cómo interpretar sus resultados y qué acción debe llevarse a cabo después.

Consideraciones de diseño y seguridad#

Las habilidades eficaces deben tener responsabilidades concretas, descripciones de activación claras, instrucciones concisas, ejemplos realistas y dependencias documentadas. Las buenas prácticas oficiales de creación de habilidades recomiendan adaptar el nivel de detalle de las instrucciones al riesgo de la tarea: una orientación flexible puede ser adecuada para análisis abiertos, mientras que las operaciones frágiles requieren scripts exactos y restricciones más estrictas.

Las habilidades de terceros deben tratarse como software instalado. Revisa todas las instrucciones, scripts, dependencias, llamadas de red y operaciones de archivos antes de conceder acceso. Aplica aislamiento en un entorno controlado, permisos con los mínimos privilegios, límites de recursos, registros y aprobación humana para las acciones de consecuencias relevantes. Estos controles ayudan a abordar los riesgos descritos en la guía de OWASP sobre inyección de prompts y la guía de OWASP sobre agencia excesiva. Los equipos también pueden utilizar el Playbook del Marco de gestión de riesgos de IA del NIST para integrar la evaluación, la supervisión y la gobernanza de las habilidades en una gestión más amplia de los riesgos de IA.