Plugin

Un plugin es un paquete distribuible de extensiones de Claude Code. Agrupa una colección de componentes, como skills, agentes, hooks, servidores MCP o servidores LSP, en una única unidad para facilitar su distribución y gestión.

El manifiesto del plugin, un archivo llamado plugin.json, se encuentra dentro del directorio .claude-plugin/ del plugin. Las skills incluidas en un plugin residen en el subdirectorio skills/. Estas skills se nombran automáticamente utilizando el nombre del plugin. Por ejemplo, una skill en my-plugin/skills/review/SKILL.md se accede como /my-plugin:review. Este nombramiento evita conflictos con skills instaladas localmente o dentro de un proyecto.

Para una skill ubicada directamente en el directorio raíz del plugin (un SKILL.md raíz del plugin), el nombre del comando se determina por el campo name en su frontmatter. Si el campo name está ausente, el nombre del directorio del plugin se usa como nombre del comando.

Por el contrario, una carpeta de skill también puede funcionar como un plugin al incluir un archivo .claude-plugin/plugin.json. Esto permite que un único directorio de skill agrupe componentes adicionales como agentes, hooks y servidores MCP. Al usar este método dentro del directorio .claude/skills/ de un proyecto, primero se debe aceptar el diálogo de confianza del espacio de trabajo.

Por razones de seguridad, los subagentes dentro de los plugins tienen ciertos campos de frontmatter deshabilitados: hooks, mcpServers y permissionMode. Para aplicar los cambios realizados en los directorios hooks/, .mcp.json, agents/ y output-styles/ de un plugin, debes ejecutar el comando /reload-plugins.