Plugins
Una configuración en la que confías vale mucho más cuando todo tu equipo la está usando.
El problema es moverla de un lado a otro. Construyes un excelente directorio .claude con
skills, subagentes y hooks, ¿y luego qué? Todos copian y pegan
archivos entre máquinas y esperan que se mantengan sincronizados. Los plugins resuelven eso. Un
plugin es la forma en que Claude Code empaqueta una configuración y la traslada de una persona a
la siguiente.
Esto tiene dos caras, y cubriremos ambas. Primero, usar plugins que otras personas publican. Segundo, empaquetar el tuyo propio una vez que hayas construido algo que vale la pena compartir.
Qué es un plugin
Un plugin es una unidad instalable. Agrupa todo lo que de otro modo compartirías manualmente: skills, subagentes, hooks y configuraciones de servidores MCP, además de la lista más larga de elementos como servidores de protocolo de lenguaje, monitores en segundo plano y temas. Una versión, una instalación.
Dónde vive el plugin determina cómo lo instalas. Dentro de una sesión, puedes instalar uno directamente por nombre:
/plugin install github@claude-plugins-officialEl comando abre primero los detalles del plugin, para que puedas revisarlo y elegir un alcance. Luego Claude Code lo instala e imprime un breve resumen. O bien dice que el plugin ya está activo en esta sesión, o menciona /reload-plugins y Claude Code ejecuta esa recarga por ti. Solo intervienes si la recarga advierte que tu próximo mensaje releería toda la conversación: ejecuta /reload-plugins --force para activar el plugin de todos modos.
Agregar un marketplace para tu equipo
Para un equipo, la mejor opción es agregar un marketplace privado una sola vez. Un marketplace es una fuente compartida a través de la cual se resuelven los plugins:
/plugin marketplace add your-org/claude-pluginsLlámalo como quieras. Una vez agregado, cada instalación posterior se resuelve a través de él. Obtienes descubrimiento centralizado, seguimiento de versiones y actualizaciones en un solo lugar en lugar de dispersos en las laptops de todos.
Puedes explorar lo disponible desde la pestaña Discover. Enumera los plugins de tus marketplaces para que puedas buscar y elegir.
Lee antes de instalar
Aquí está la parte más importante. Un plugin ejecuta código en tu máquina, con tus privilegios. Sus hooks se activan en cada llamada de herramienta coincidente. Así que si instalas un plugin por sus skills, también obtienes sus hooks PreToolUse y Stop, los hayas leído o no.
Piensa en lo que eso significa. Un plugin de la comunidad podría incluir un hook Stop que llame a un endpoint de red cada vez, y nada en tu configuración te advertiría sobre ello. Esa no es una razón para evitar los plugins. Es una razón para revisar primero.
Antes de instalar, revisa los detalles del plugin. Claude Code te muestra lo que instalará y estima el costo de contexto, junto con una advertencia clara de que Anthropic no controla lo que hay dentro de los plugins de terceros.
Dos cosas que vale la pena saber sobre de dónde provienen los plugins:
- Un plugin llega al marketplace de la comunidad porque la persona que lo escribió lo envió a Anthropic.
- El marketplace oficial se cura en su propia vía separada.
Pero estar listado no es lo mismo que ser confiable. Así que la regla se mantiene: instala plugins y agrega marketplaces solo de fuentes en las que realmente confíes, y verifica qué hace realmente un plugin antes de activarlo.
Los componentes se ejecutan junto a los tuyos
Un plugin no sobrescribe tu configuración. Sus componentes se ejecutan junto a los tuyos propios. Eso es mayormente bueno, pero tiene consecuencias que debes entender.
Los hooks se acumulan. El hook PreToolUse de un plugin y tu propio hook PreToolUse se activan ambos en cada llamada de herramienta. Ninguno reemplaza al otro. Es precisamente por eso que lees los detalles primero.
Las skills, agentes y comandos están bajo espacio de nombres según el nombre del plugin, así que nunca chocan con los tuyos.
Una vez que un plugin está instalado puedes ver todo lo que agregó, gestionarlo y desinstalarlo desde el panel de plugins.
Empaquetar tu propio plugin
Ahora el otro lado. Una vez que hayas construido un directorio .claude que funcione, no hagas que tu equipo lo copie y pegue entre máquinas. Empaquétalo en su lugar.
La buena noticia es que no tienes que reescribir nada. Copias las piezas de tu directorio .claude en la propia carpeta del plugin:
svg-splitter-review/
├── .claude-plugin/plugin.json
├── skills/<skill-name>/SKILL.md
├── agents/<agent-name>.md
├── hooks/hooks.json
└── .mcp.jsonLos hooks son la única pieza que sale de settings.json: copia el objeto hooks en hooks/hooks.json. Claude Code descubre el resto por convención. Para probar el plugin antes de compartirlo, inicia una sesión con su carpeta:
claude --plugin-dir ./svg-splitter-reviewUna vez que funcione, elimina los originales de .claude y saca el objeto hooks de settings.json. Hasta que lo hagas, cada hook se ejecuta dos veces.
El manifiesto
Además de eso, hay un manifiesto opcional. Vive en .claude-plugin/plugin.json y contiene el nombre, la versión, la descripción y el autor:
{
"name": "svg-splitter-review",
"version": "0.1.0",
"description": "Reviews the SVG Splitter repo",
"author": {
"name": "Lewis Menelaws"
}
}El manifiesto es opcional. Omítelo y Claude Code seguirá descubriendo tus componentes por convención de directorio. Pero hay un par de detalles que vale la pena conocer:
- El nombre es el único campo obligatorio. Pone tus skills bajo espacio de nombres como
/plugin-name:skill-name, así que una skill en este plugin se ejecuta como/svg-splitter-review:<skill-name>. Eso evita que tus skills choquen con las de cualquier otra persona. - Versiónalo como cualquier otra dependencia. Eso es lo que hace que las actualizaciones y el seguimiento de versiones funcionen en todo tu equipo.
La conclusión
Dos reglas simples cubren la mayor parte de esto:
- Cuando uses plugins, lee antes de instalar. Un plugin ejecuta código con tus privilegios, así que revisa primero sus hooks, agentes y servidores MCP.
- Cuando construyas uno, empaqueta tu
.claudeen el momento en que funcione. Un manifiesto, una instalación.
Ese es el punto central. Una unidad instalable, y la configuración en la que confías llega a todo tu equipo.