Agent Skills

Agent Plugins usa la especificación de Agent Skills sin redefinir el formato de las Agent Skills. Agent Plugins solo define dónde se descubren dentro de un plugin y cómo se aíslan los fallos.

Estructura de directorios

Coloca cada Agent Skill en un directorio secundario directo de skills/:

skills/
└── deploy/
    ├── SKILL.md
    ├── scripts/
    │   └── rollback.sh
    ├── references/
    │   └── runbook.md
    ├── assets/
    └── examples/

Un elemento secundario directo se considera una Agent Skill descubierta cuando su ruta llamada exactamente SKILL.md se resuelve a un archivo normal. Los clientes no buscan otras Agent Skills de forma recursiva en descendientes más profundos.

Formato de Agent Skills

El frontmatter y las instrucciones de SKILL.md siguen la especificación de Agent Skills. Una Agent Skill puede contener cualquier archivo o directorio adicional que necesite. scripts/, references/ y assets/ son convenciones habituales descritas por Agent Skills, no una lista exhaustiva de elementos permitidos. La especificación de Agent Skills es la fuente de referencia para determinar su validez.

Aislamiento de fallos

Si una Agent Skill descubierta no es válida, el cliente la omite, informa del problema cuando resulta práctico y continúa cargando otras Agent Skills y tipos de componentes.

Si falta skills/, el plugin sigue siendo válido. Si la ruta existe pero no es un directorio, el tipo de componente Agent Skills no es válido, pero los componentes independientes, como los servidores MCP, conservan su validez.