Crear un Agent Plugin

Un Agent Plugin es un directorio autónomo. Cada plugin tiene un plugin.json en la raíz; las Agent Skills y la configuración MCP son opcionales.

Crear un plugin mínimo

hello-plugin/
├── plugin.json
└── skills/
    └── greet/
        └── SKILL.md

Crea plugin.json:

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "hello-plugin"
}

Crea la Agent Skill:

---
name: greet
description: Greet the user and offer help.
---

Greet the user and offer help.

Un cliente compatible con Agent Skills carga plugin.json, descubre los elementos secundarios directos de skills/ y valida cada SKILL.md según la especificación de Agent Skills. Para añadir servidores MCP, coloca mcp.json en la raíz del plugin y usa la misma versión del schema de Agent Plugins.

El ejemplo de Agent Plugins ofrece un paquete que puedes copiar, con un manifiesto completo y una Agent Skill funcional.

Límites del paquete

Las rutas resueltas de los archivos incluidos en el paquete deben permanecer dentro de la raíz del plugin. Los campos de configuración definidos como rutas relativas al plugin empiezan por ./; los enlaces simbólicos y mecanismos equivalentes del sistema de archivos no deben permitir escapar del paquete.

La instalación, distribución, activación, actualización e interfaz de usuario administradas por el cliente quedan fuera de la especificación portátil.

Siguientes pasos

• Manifiesto: define la identidad, los metadatos y la versión de la especificación de destino.
• Agent Skills: incluye Agent Skills en el directorio fijo skills/.
• Servidores MCP: configura conexiones MCP locales y remotas en mcp.json.
• Extensiones de cliente: añade comportamiento con espacio de nombres para clientes concretos sin modificar el contrato portátil.