Plugins de Claude Code: empaqueta y comparte tu setup

Un plugin de Claude Code es un paquete que agrupa skills, subagentes, hooks y servidores MCP en algo instalable, versionable y compartible. Es el paso natural cuando tu configuración deja de ser personal y quieres reusarla en varios proyectos o repartirla a tu equipo.

Standalone vs plugin

Hay dos formas de extender Claude Code:

• Standalone (carpeta .claude/): ideal para flujos personales y de un solo proyecto. Nombres cortos (/deploy). Rápido para experimentar.
• Plugin (carpeta autocontenida con un manifiesto): ideal para compartir, versionar y reusar entre proyectos. Los comandos quedan con namespace (/mi-plugin:deploy), lo que evita conflictos cuando tienes varios instalados.

Regla práctica: empieza standalone en .claude/ y, cuando algo te sirva y quieras compartirlo, lo conviertes en plugin.

Por qué te importa (el caso de equipo)

El valor real del plugin aparece en equipo. Imagina un plugin interno para tu equipo Laravel que trae, todo junto: la skill de "revisar PR" con pint y php artisan test, un hook que formatea al guardar, un subagente de revisión y el servidor MCP de tu base de datos. Cada persona nueva hace una instalación y arranca con el mismo setup, sin copiar carpetas a mano. Eso es lo que un plugin resuelve: configuración reproducible.

Qué empaqueta un plugin

Un plugin puede incluir, cada uno en su carpeta en la raíz del plugin:

También puede traer servidores LSP y monitors. Ojo con el error más común: solo plugin.json va dentro de .claude-plugin/; el resto de carpetas (skills/, agents/, hooks/) van en la raíz del plugin, no dentro de .claude-plugin/.

Crear un plugin

El manifiesto vive en .claude-plugin/plugin.json y es opcional: sin él, Claude Code carga los componentes que encuentra en la estructura estándar y toma el nombre del marketplace o de la carpeta. Si lo escribes, el único campo obligatorio es name; description es opcional, pero conviene ponerlo desde el principio:

{
  "name": "mi-plugin",
  "description": "El setup de Claude Code de mi equipo"
}

version es opcional, pero conviene ponerlo en cuanto lo compartas (así puedes versionar los cambios). El name es el namespace de los comandos. Para probarlo en local sin instalar nada, lánzalo con el flag de desarrollo:

claude --plugin-dir ./mi-plugin

claude plugin init mi-tool te genera un esqueleto en ~/.claude/skills/mi-tool/, que Claude Code carga en todas tus sesiones, y con /reload-plugins recargas los cambios sin reiniciar la sesión.

Cómo instalar plugins en Claude Code

Con el comando /plugin gestionas e instalas plugins desde marketplaces. Anthropic publica tres de uso general; los dos que más vas a usar son:

• claude-plugins-official: el oficial. Claude Code lo agrega solo la primera vez que abres una sesión interactiva. La mayoría de sus plugins los publican partners y otros autores; Anthropic mantiene un grupo más chico, como commit-commands o code-review.
• El marketplace comunitario (claude-community): lo agregas con /plugin marketplace add anthropics/claude-plugins-community y luego instalas con el sufijo @claude-community.

El tercero es el de demo (claude-code-plugins), que se agrega con /plugin marketplace add anthropics/claude-code.

El plugin claude-code-setup

Si no sabes por dónde empezar, el marketplace oficial trae claude-code-setup, un plugin de Anthropic pensado justo para eso. Analiza tu repositorio y te recomienda una o dos automatizaciones por categoría: servidores MCP (por ejemplo Context7 para documentación), skills, hooks, subagentes y slash commands.

Se instala como cualquier plugin del marketplace oficial. Dentro de una sesión, el comando no lo instala de inmediato: abre el panel /plugin con sus detalles para que elijas el alcance (solo tú, todo el repo o solo tú en este repo) y confirmes.

/plugin install claude-code-setup@claude-plugins-official

Trae una sola skill, claude-automation-recommender, y no la invocas por nombre: Claude la usa cuando le pides algo como "recommend automations for this project", "help me set up Claude Code" o "¿qué hooks debería usar?". Es de solo lectura: analiza el código y te devuelve las recomendaciones, pero no crea ni modifica archivos. Lo que decidas adoptar lo configuras tú, ya sea en .claude/ o empaquetado en tu propio plugin.

Preguntas frecuentes

Fuentes

• Plugins overview (documentación oficial de Claude Code)
• Create a Claude Code plugin (documentación oficial de Claude Code)
• Plugin manifest reference (documentación oficial de Claude Code)
• Add components to a plugin (documentación oficial de Claude Code)
• Install and manage plugins (documentación oficial de Claude Code)
• Anthropic's marketplaces (documentación oficial de Claude Code)
• claude-code-setup (repositorio oficial del marketplace de Anthropic)