Extiende el Modo agente con habilidades

Las habilidades te permiten mejorar las capacidades del Modo agente con conocimientos especializados y flujos de trabajo personalizados. Se basan en el estándar abierto de Habilidades del agente.

A diferencia de los archivos AGENTS.md, las habilidades representan la experiencia a pedido. Esta estructura permite que el Modo de agente mantenga una gran cantidad de capacidades especializadas, como migrar entre versiones específicas de la biblioteca o hacer que un elemento componible se adapte a diferentes tamaños de pantalla, sin saturar la ventana de contexto inmediata del modelo.

El modelo decide de forma autónoma cuándo emplear una habilidad según tu solicitud y la descripción de la habilidad. Cuando se identifica una habilidad pertinente, el modelo extrae de forma dinámica las instrucciones y los recursos completos necesarios para completar la tarea.

Para activar una skill a pedido, pídele al agente que realice una tarea relevante para la skill. También puedes ingresar @ en el cuadro de entrada para activar una habilidad específica.

Beneficios principales

  • Experiencia compartida: Empaqueta flujos de trabajo complejos (como el proceso de revisión de solicitudes de extracción de un equipo específico) en una carpeta dedicada que cualquiera puede usar.
  • Flujos de trabajo repetibles: Proporciona instrucciones estándar para garantizar que las tareas complejas de varios pasos se realicen de manera coherente.
  • Agrupación de recursos: Incluye secuencias de comandos, plantillas o datos de ejemplo junto con tus instrucciones para que el agente tenga todo lo que necesita en un solo lugar.
  • Uso eficiente de la ventana de contexto: Para ahorrar tokens de contexto, solo se carga inicialmente la metainformación de la habilidad (nombre y descripción). El archivo SKILL.md completo solo se carga cuando se activa. Los archivos de asistencia dentro de los directorios references/, scripts/ o assets/ solo se cargan en el contexto cuando el agente los necesita específicamente.

Crea tus propias habilidades

El agente busca habilidades a partir de los directorios .skills/ o .agent/skills/ ubicados en la raíz del proyecto. Para crear una skill personalizada, sigue estos pasos:

  1. Crea un directorio para tu skill (por ejemplo, my-new-skill/).
  2. Crea un archivo SKILL.md (distingue mayúsculas de minúsculas) dentro del directorio nuevo.

Las skills deben cumplir con las siguientes reglas:

  • Un directorio por skill: Cada skill debe tener su propio directorio único que incluya un archivo SKILL.md y cualquier recurso adicional.
  • Anidamiento: Todas las habilidades deben estar en el directorio .skills/ o .agent/skills/ en la raíz del proyecto. Sin embargo, puedes usar subdirectorios para una mejor organización (por ejemplo, skills/ui-flows/<skill name>/SKILL.md o skills/testing/<skill name>/SKILL.md).
  • Alcance: Actualmente, solo se admiten las habilidades ubicadas dentro de la base de código del proyecto.

El archivo SKILL.md usa un bloque YAML para los metadatos y Markdown estándar para las instrucciones.

  • name: Es un identificador único de la skill. Debe coincidir con el nombre del directorio.
  • description: Es una explicación clara de lo que hace la habilidad y cuándo el agente debe usarla.
  • Cuerpo: El cuerpo de Markdown debajo del bloque YAML contiene las instrucciones que guían el comportamiento del agente cuando la habilidad está activa.
---
name: skill-name
description: A description of what this skill does and when to use it.
metadata:
  author: example-org
  version: "1.0"
---

Skill content

Lineamientos de formato

  • Nombre: Máximo de 64 caracteres (solo letras en minúscula, números y guiones).
  • Descripción: Máximo de 1,024 caracteres
  • Contenido del cuerpo: Intenta usar entre 10,000 y 20,000 caracteres (entre 2,500 y 5,000 tokens). Si tus instrucciones superan este límite, considera trasladar la documentación detallada a un archivo de recursos, como se describe en Directorios de habilidades opcionales.

Directorios de habilidades opcionales

Para que tu archivo SKILL.md sea conciso y modular, puedes incluir recursos adicionales en los siguientes directorios opcionales dentro de la carpeta de tu skill:

  • scripts/: Contiene código ejecutable (por ejemplo, Python o Bash) que el agente puede ejecutar.
  • references/: Contiene documentación técnica detallada, referencias de API o guías específicas del dominio.
  • assets/: Contiene recursos estáticos, como plantillas de documentos, diagramas de IU o esquemas JSON.

Cuando hagas referencia a estos archivos en tus instrucciones de SKILL.md, usa rutas de acceso relativas desde la raíz de la skill. Por ejemplo: Run the script at scripts/cleanup.py.