Habilidades de agente de Ultralytics#
Las habilidades de agente de Ultralytics proporcionan instrucciones y material de referencia a los agentes de programación con IA compatibles para trabajar con el paquete Python ultralytics, la CLI yolo y Ultralytics Platform, incluida la automatización con ul cloud. Siguen el formato abierto Agent Skills y se cargan cuando se solicita una tarea pertinente.
Cómo funcionan las habilidades#
La habilidad de enrutamiento yolo asigna una solicitud a la fase del ciclo de vida correspondiente, y cada habilidad de fase cubre ambas vías: la más rápida en Ultralytics Platform y, después, el flujo de trabajo local con Python y CLI. Los datos sujetos a cambios de versión, como los nombres de los pesos, los argumentos de entrenamiento y los formatos de exportación, se encuentran en catálogos basados en una versión fijada de ultralytics, y cada habilidad indica al agente que confíe en el paquete instalado (yolo checks, yolo cfg y los mensajes de error) si hay discrepancias. La habilidad platform-cli se remite, en cambio, a la ayuda de la CLI ul instalada y a la API de Platform en tiempo real. La función Ask AI de Platform también usa la misma habilidad platform-cli.
Habilidades disponibles#
El repositorio contiene un enrutador, seis habilidades del ciclo de vida y una habilidad para la CLI de Platform:
| Habilidad | Se usa para |
|---|---|
yolo | Uso básico de Python y la CLI, flujos de trabajo de Platform y derivación a las demás habilidades |
yolo-models | Selección de familias, tamaños y tareas de modelos, y de sus pesos |
yolo-datasets | Preparación, conversión, validación y resolución de problemas de conjuntos de datos |
yolo-training | Entrenamiento, validación, reanudación, uso de varias GPU y resolución de problemas |
yolo-tuning | Ajuste de hiperparámetros y mejora de experimentos |
yolo-inference | Predicción, resultados, seguimiento y Solutions |
yolo-export | Exportación, cuantización, formatos de implementación y evaluación comparativa |
platform-cli | Automatización de Ultralytics Platform con ul cloud: recursos, cargas, entrenamiento en la nube, exportaciones e implementaciones |
Instalación#
claude plugin marketplace add ultralytics/skills
claude plugin install yolo@ultralyticsPara actualizarla, ejecuta claude plugin update yolo@ultralytics y reinicia Claude Code.
Cada versión del plugin se publica como una versión de GitHub con notas de la versión.
Conecta la CLI de Platform#
La habilidad platform-cli usa la CLI ul (Python 3.11+), incluida con pip install ultralytics o con el SDK independiente (pip install ultralytics-platform). Crea una clave de API de Platform, ponla a disposición de tu agente y comprueba la conexión:
export ULTRALYTICS_API_KEY="YOUR_API_KEY" # or: ul login YOUR_API_KEY
ul cloud account summaryEjemplos de prompts#
Una vez instalada, habla con el agente con naturalidad. El enrutador yolo seleccionará las indicaciones pertinentes:
| Objetivo | Ejemplo de prompt |
|---|---|
| Prueba YOLO | «Ejecuta YOLO en una imagen de muestra y muéstrame qué detecta». |
| Entrenar | «Convierte mis imágenes en un modelo YOLO personalizado, etiquetado y entrenado en Ultralytics Platform». |
| Mejora | «El mAP de mi modelo se ha estancado. Analiza la ejecución y propón el siguiente experimento». |
| Despliega | «Exporta mi modelo YOLO entrenado a TensorRT con cuantización INT8 y evalúa su rendimiento». |
| Analiza vídeo | «Cuenta los coches que cruzan una línea en traffic.mp4 y guarda el vídeo anotado». |
| Automatiza Platform | «Enumera mis conjuntos de datos de Ultralytics Platform e inicia el entrenamiento en la nube con el de PPE». |
Consulta el repositorio ultralytics/skills para ver los comandos de instalación actuales, los archivos de origen, las actualizaciones y cómo informar de problemas.
Preguntas frecuentes#
Son instrucciones reutilizables y material de referencia que ayudan a los agentes de programación con IA a trabajar con Ultralytics Platform, el paquete Python
ultralytics, la CLIyoloy la CLI de Platformul.El repositorio ofrece complementos para Claude Code y Codex. Cursor, Gemini CLI y otros agentes que lean el formato abierto Agent Skills pueden instalar directamente las carpetas de habilidades o hacerlo mediante la CLI de skills.
Instala el complemento completo para que el enrutamiento automático abarque todo el ciclo de vida de la visión artificial y las operaciones de la CLI de Platform. Para instalar una sola habilidad con la CLI de skills, pasa su nombre mediante
--skill, como--skill yolo-trainingo--skill platform-cli.El plugin solo contiene instrucciones, así que no se ejecuta nada al cargarse. Los comandos que ejecuta tu agente desde las habilidades pueden descargar paquetes, pesos y conjuntos de datos, y los comandos
ul cloudsuben a Ultralytics Platform los archivos que les pases usando tu clave de API. El paqueteultralyticstambién envía datos anónimos de uso, opción queyolo settings sync=Falsedesactiva.No. Las habilidades orientan al agente hacia el flujo de trabajo pertinente, pero el paquete instalado y la documentación actual de Ultralytics siguen siendo la referencia definitiva cuando difieren el comportamiento o las opciones admitidas.
Abre un informe de errores en el repositorio
ultralytics/skillse incluye el prompt que has usado, las indicaciones del agente y lo que debería haber ocurrido.