Inicio / Extender: habilidades, MCP, subagentes, hooks, plugins

Plugins: agrupar skills, hooks, MCP y agentes

Un plugin agrupa skills, hooks, servidores MCP, comandos y subagentes en un solo directorio versionado, instalable y compartible de una sola vez. Su manifiesto, plugin.json, es el único archivo de .claude-plugin/; el error más frecuente es poner ahí skills/, commands/, agents/ o hooks/ en lugar de la raíz del plugin.

Un plugin agrupa skills, hooks, servidores MCP y comandos en un solo directorio versionado, instalable y compartible de una sola vez. La documentación oficial describe este directorio como un bundle, la misma unidad probada en local y luego publicada en una biblioteca compartida (fuente code.claude.com/docs/en/plugins, consultada el 2026-09-02).

Lo que puede contener un plugin

En la raíz del plugin, skills/ agrupa las skills del plugin, con el mismo formato SKILL.md que una skill personal o de proyecto. commands/ conserva el mecanismo histórico de comandos planos, siempre soportado en paralelo. hooks/ lleva un archivo hooks.json que declara los eventos del ciclo de vida gestionados por el plugin. .mcp.json declara los servidores MCP embebidos, disponibles desde la instalación. agents/ define subagentes dedicados al plugin. .lsp.json agrega servidores de lenguaje, monitors/ con su archivo monitors.json vigila registros en segundo plano, y bin/ agrega ejecutables directamente a la ruta usada por la herramienta Bash. Un archivo settings.json al mismo nivel fija ajustes por defecto del plugin, pero solo las claves agent y subagentStatusLine están actualmente soportadas.

El manifiesto, y una trampa frecuente

Un solo archivo vive en .claude-plugin/: plugin.json, el manifiesto. Lleva name, description, version y author. El campo name se convierte también en el namespace de los comandos del plugin: una skill llamada bonjour en un plugin llamado mon-plugin se invoca con el comando /mon-plugin:bonjour. La documentación señala explícitamente el error más frecuente en este punto: colocar skills/, commands/, agents/ o hooks/ dentro de .claude-plugin/ en lugar de ponerlos en la raíz del plugin, al lado de esa carpeta.

mon-plugin/
  .claude-plugin/
    plugin.json
  skills/
    bonjour/
      SKILL.md
  hooks/
    hooks.json
  .mcp.json

Probar antes de publicar

El comando claude --plugin-dir ./mon-plugin carga el plugin para una sesión local, un archivo .zip con el mismo contenido también funciona. El comando /reload-plugins recarga los plugins activos sin reiniciar la sesión, útil mientras se modifica hooks.json o una skill. Antes de enviar un plugin a una biblioteca compartida, claude plugin validate ./mon-plugin controla su estructura. Dos marketplaces públicos, mantenidos por Anthropic, distribuyen luego los plugins: claude-plugins-official, curada, ya registrada en el primer lanzamiento interactivo de Claude Code, y claude-community, abierta a envíos de terceros tras revisión, agregada con el comando /plugin marketplace add anthropics/claude-plugins-community.

El mismo mecanismo que hace funcionar una skill aislada, descrito en crear tu propia skill o tu propio comando, se aplica tal cual a una skill alojada en skills/ dentro de un plugin: el formato SKILL.md no cambia, solo cambia el contenedor.

Un mod es un plugin que se ejecuta con tus permisos

Desde octubre de 2026, un plugin puede contener un mod: código JavaScript o TypeScript que se ejecuta dentro de Claude Code y puede observar, reescribir o asumir una llamada de herramienta, una instrucción o un trozo de interfaz. Un mod actúa con tus permisos, puede leer tus archivos y tus variables de entorno, lanzar procesos y aprobar una llamada de herramienta antes de que se te pregunte, y no está en el sandbox, el aislamiento de los comandos Bash. Audítalo como una skill de terceros, aún más estrictamente. Antes de instalar, lista lo que pide sin ejecutarlo:

claude plugin validate ./un-mod

Las líneas hooks: y calls: de la salida dan los eventos gestionados y lo que el mod pide hacer a Claude Code. El mod integrado «You should know» sigue desactivado mientras tú no lo actives.

Para instalar, claude plugin install --marketplace <source> añade la marketplace si hace falta y luego instala, bajo los mismos controles de política, y claude plugin configure <plugin> muestra las opciones del plugin y las que no están rellenadas. La instalación rechaza las fuentes npm que son repositorios git o carpetas.