Cómo elegir un plugin e instalarlo con seguridad

Un skill dejó la página bastante mejor, y el siguiente paso parece obvio: instalar no uno, sino diez de golpe. En ese momento un compañero le manda un enlace: "instálalo, es muy útil". Todo esto se instala con un solo comando, y ahí está la trampa. Un plugin parece una lista de habilidades, pero en realidad es código que va a funcionar en su máquina con sus permisos y a ocupar espacio en cada conversación con el agente.

Veremos en qué se diferencia un plugin de un skill y qué puede traer dentro, de dónde salen los catálogos y cómo distinguir una fuente fiable de una cualquiera, qué muestra Claude Code antes de instalar y cómo leerlo. Después recorreremos todo el camino: instalar, probar con una tarea propia, desactivar, eliminar. Al final, qué hacer antes de cada instalación y por qué lo mismo vale para cualquier skill que el agente haya traído de internet.

1. Skill y plugin

Un carpintero tiene sus procedimientos por escrito: cómo preparar el banco, cómo afilar, cómo sacar una serie con plantilla. Mientras trabaja solo, los guarda en su cuaderno. Luego el vecino de taller le pide uno, el aprendiz otro, y al mes llama el taller de enfrente, y mandarle a cada uno su hojita acaba cansando. Entonces mete varios procedimientos en una caja, le estampa en un costado el sello del taller y deja dentro una nota: qué hay aquí y cómo se usa. Una caja así se puede entregar entera, actualizar y numerar.

Eso es un plugin. No una habilidad más, sino un envoltorio alrededor de varias.

Por sí mismo, un plugin no es una habilidad aparte, sino una forma de repartir varias. Todo lo que puede hacer, lo hace a través de lo que lleva dentro: habilidades, ayudantes, reacciones automáticas, conexiones. Por eso la pregunta "qué sabe hacer el plugin" siempre se reduce a otra: qué hay dentro.

Un plugin propio se arma cuando otras personas empiezan a pedirle sus skills. Si duda de qué necesita exactamente (un skill, un ayudante con un rol propio o un plugin), pregúntele al agente, pero pídale que primero le haga preguntas y no que lo arme de entrada: él preparará un borrador, y lo que hay dentro lo revisa usted. La pauta es sencilla: si repite siempre la misma petición, un skill; si el trabajo secundario ensucia la conversación, un ayudante; si necesita el mismo conjunto en otro proyecto, un plugin. Cómo se arma un plugin paso a paso es otro tema. Este artículo es para quien recibe la caja.

2. Qué hay dentro de un plugin

Lo más habitual es que la caja tenga cinco compartimentos, y no todos son igual de inofensivos.

• skills - procedimientos que el agente aplica por su cuenta según la descripción o cuando usted se lo indica;
• agents - ayudantes con un rol propio a los que el agente encarga parte del trabajo;
• hooks - reacciones automáticas a eventos: ejecutan comandos sin que usted lo pida cuando ocurre algo;
• MCP servers - conexiones con servicios externos; a través de ellas el agente lee y cambia cosas fuera de su computadora;
• LSP servers - sugerencias de código para un lenguaje concreto; necesitan un programa instalado aparte.

Los dos compartimentos de abajo son el motivo por el que la caja se revisa al recibirla y no se deja tirada en un rincón. Un plugin con hooks y MCP hace cosas que uno no espera de un "conjunto de habilidades": ejecutar comandos y conectarse a servicios externos. Dentro hay una herramienta viva y con corriente, no un póster para la pared. Qué son los hooks, MCP y agents por separado da para otros artículos; aquí basta con saber qué significan dentro del conjunto. También hay compartimentos aparte de estos cinco, por ejemplo la configuración por defecto o el estilo de las respuestas del agente, pero no cambian el panorama.

Si no tiene la ficha a mano, pídale al agente que abra el repositorio del plugin y le cuente qué hay en sus carpetas.

3. Nombre con prefijo

Los skills de un plugin llevan prefijo: /nombre-plugin:nombre-skill, por ejemplo /commit-commands:commit. El vecino también puede tener una "limpieza", y mientras la caja lleve su sello, no hay forma de confundirlas.

El precio es un nombre largo: el conjunto compartido se paga con comandos más largos de escribir. Un skill propio en la carpeta del proyecto no lleva prefijo.

También tiene su ventaja. Por el prefijo, en el menú de / siempre se ve de dónde viene el comando y de quién es la caja.

4. El catálogo y los dos pasos

Las cajas se sacan del almacén. Un catálogo de plugins, en inglés marketplace, es una lista de plugins ajenos que alguien mantiene. Se trabaja con él en dos pasos: primero se añade el catálogo y luego se instalan sus plugins de uno en uno. Añadir el catálogo no instala nada por sí solo, usted solo recibe la lista.

La mayoría ya tiene hecho el primer paso. El comando /plugin abre un panel con cuatro pestañas: Discover, para buscar plugins en todos los catálogos añadidos; Installed, lo que tiene instalado; Marketplaces, los catálogos; Errors, los errores de carga. El catálogo oficial de Anthropic está añadido desde el primer arranque, y en la pestaña Discover sus plugins se ven enseguida: elegir, abrir, instalar. La misma lista está en el sitio claude.com/plugins, si prefiere verla sin Claude Code.

Un segundo catálogo aparece cuando el plugin que necesita no está en el oficial: el catálogo de la comunidad o un repositorio ajeno que contiene un archivo de catálogo. Se añade con un comando, y un plugin de él se instala también con uno:

/plugin marketplace add anthropics/claude-plugins-community   # añadir el catálogo de la comunidad
/plugin install nombre-plugin@claude-community                # instalar un plugin de ese catálogo
/plugin list                                                  # comprobar que el plugin está en la lista

Un catálogo ajeno se añade con ese mismo primer comando, solo que con su dirección.

Hay un detalle en el que se tropieza más que en ningún otro (yo tampoco me libré). El nombre del catálogo para instalar no sale del nombre del repositorio, sino de la descripción del propio catálogo: el repositorio se llama anthropics/claude-plugins-community, pero se instala desde claude-community. Qué nombre tiene el catálogo se ve en la pestaña Marketplaces.

En el catálogo oficial hay plugins de distintos tipos. La integración con GitHub es MCP, una conexión a un servicio externo. Las sugerencias de código para un lenguaje, por ejemplo typescript-lsp, son LSP. security-guidance revisa cada cambio del agente en busca de vulnerabilidades típicas.

5. Tres niveles de confianza en la fuente

Un plugin no se carga por sí solo desde una carpeta: hay que instalarlo de forma explícita, y no es burocracia. Dentro hay código que se ejecutará con sus permisos, es decir, podrá hacer lo mismo que usted delante de esta computadora. Por eso la primera pregunta sobre cualquier plugin no es "qué sabe hacer", sino "de dónde viene".

Catálogo oficial. Lo mantiene Anthropic, pero la mayoría de sus plugins son de socios y otros autores, no de la propia Anthropic. Requiere menos atención que un repositorio ajeno, pero aun así conviene leer la descripción y el contenido.

Catálogo de la comunidad. Plugins de terceros que han pasado la revisión automática de Anthropic; casi todos están fijados a una versión concreta en el catálogo. Es un filtro, no una garantía: nadie ha comprobado que el plugin haga exactamente lo que promete.

Un repositorio o una carpeta cualquiera. Sin ninguna revisión. Usted mismo mira quién es el autor, si hay una descripción clara y qué hay en las carpetas.

En una misma sesión de trabajo pueden aparecer los tres niveles: un plugin de diseño del catálogo de la comunidad, otro del catálogo de Anthropic y un tercero de un repositorio ajeno con un único plugin dentro. Es normal, siempre que sepa en qué nivel está en cada momento.

La cautela depende del plugin. Cuanto más sabe hacer, es decir, cuantos más hooks y MCP lleva, y cuanto más lejos está la fuente de la oficial, con más atención hay que mirarlo.

6. Qué muestra Claude Code antes de instalar

La fuente marca con cuánta atención hay que mirar. Los detalles los muestra el propio Claude Code: abra el plugin desde la pestaña Marketplaces del panel /plugin o con el comando /plugin install nombre@catálogo y verá su ficha. La ficha de la lista Discover es más corta: no incluye la estimación del coste.

En ella hay tres líneas que son la razón de todo esto. Las dos últimas solo aparecen en los plugins del catálogo oficial.

• Will install - el contenido: cuántos skills, agents, hooks, MCP y LSP van a llegar;
• Context cost - cuánto añadirá el plugin a la ventana del agente: Every turn, en cada petición suya; When invoked, cuando el agente cargue sus skills y agents;
• Last updated - cuándo se actualizó el plugin.

Will install:  skills: 8   agents: 1   hooks: 2   MCP servers: 1
Context cost:  Every turn: ~400 tokens   When invoked: ~1.5k tokens
Last updated:  2 weeks ago

Los números y el aspecto de las líneas son orientativos, cada plugin y cada versión de Claude Code tiene los suyos. Leer el contenido es sencillo, pero es solo una primera aproximación: si dentro solo hay skills, lo más probable es que el plugin lea y sugiera; si hay hooks o MCP, ejecuta comandos o sale al exterior, y eso es motivo para abrir la descripción y entender cuáles exactamente. La ficha no lo muestra todo: el plugin puede traer además archivos ejecutables y configuración por defecto que no aparecen en ella. Si la fuente no le resulta conocida, eche un vistazo también al repositorio.

Y una tercera pregunta que la ficha no le hará: si el plugin le sirve a usted. Incluso un buen plugin puede quedarse sin instalar. Puede que duplique un skill suyo, arrastre scripts para otro sistema operativo o resuelva un problema que usted no tiene.

7. Para quién queda el plugin

Para quién queda la caja se decide de antemano, al instalar. Hay tres opciones.

• user - para usted, en todos sus proyectos;
• project - para todos los que trabajan con este repositorio: la entrada va a .claude/settings.json y viaja junto con el proyecto;
• local - para usted y solo en este proyecto, sus compañeros no lo ven.

Existe también managed: lo instala un administrador y no se puede cambiar. La mayoría no se lo encontrará.

La regla es una sola: el scope más estrecho que sirva. Menos sitios donde el plugin está activado significa menos situaciones en las que llega a ejecutarse y menos cosas que limpiar después. Un plugin dudoso no se vuelve inofensivo por tener un scope estrecho: allí donde está activado, puede hacer exactamente lo mismo. El project scope merece mención aparte: usted no decide solo por sí mismo. Para un compañero que abra el repositorio, el plugin estará activado pero no instalado: en la pestaña Errors del panel /plugin aparecerá un aviso, y tendrá que instalar el plugin él mismo.

Al instalar desde el panel se pregunta el scope; /plugin install también abre la ficha con la opción de elegir.

8. Instalar y probar

Si la instalación fue bien, termina con una de dos frases. O el plugin ya está activo, o se le pide ejecutar /reload-plugins. En el segundo caso, lo ejecutamos; si el comando avisa de que la recarga volverá a leer la conversación, lo repetimos con --force. No hace falta reiniciar Claude Code.

Que el plugin quedó instalado se ve con /plugin list: aparece en la lista, y sus skills salen con prefijo en el menú de /.

Una caja abierta ocupa el banco de trabajo. Un plugin activado añade desde el primer segundo a la ventana del agente los anuncios de sus skills: nombres y descripciones. El contenido completo se carga solo cuando el skill entra en juego, pero los anuncios están siempre ahí. En las conexiones con servicios externos llegan de inmediato los nombres de las herramientas, y las descripciones, a medida que hacen falta; las reacciones automáticas apenas ocupan ventana. Cuanto más llena está la ventana, más cara y más lenta es cada respuesta.

El coste real solo se ve comparando: /context muestra qué ocupa la ventana. Ejecútelo antes de instalar y después.

1) sin plugin: una tarea propia, anotar el resultado
2) instalar el plugin, si hace falta /reload-plugins
3) la misma tarea otra vez
4) comparar y decidir: mantener, desactivar, eliminar

El resultado de la comparación no aparece aquí a propósito: cada uno obtiene el suyo. El criterio es sencillo: usted puede decir en dos frases qué hace el plugin y dar un motivo para mantenerlo o quitarlo, sacado de su propia prueba y no de la descripción.

9. Desactivar, eliminar, quitar el catálogo

Son tres acciones, y distintas. /plugin disable desactiva, pero no elimina: el plugin deja de ocupar la ventana, y para recuperarlo está /plugin enable. /plugin uninstall lo quita del todo. /plugin marketplace remove quita el catálogo, y con él se eliminan todos los plugins que se instalaron desde ahí. Es fácil olvidarlo.

/plugin disable nombre-plugin@catalogo      # desactivar sin perderlo
/plugin uninstall nombre-plugin@catalogo    # eliminar del todo
/plugin marketplace remove catalogo         # quitar el catálogo y todo lo que se instaló desde él

Los comandos abren el mismo panel y lo dejan abierto; se cierra con Esc. En la pestaña Installed se hace lo mismo sin comandos: los plugins con problemas aparecen arriba y los desactivados, plegados abajo. Si elimina un plugin activado para todo el proyecto, Claude Code le preguntará: solo para usted o para todos.

Limpieza. Los plugins que usted instaló por su cuenta y no ha usado en dos semanas a lo largo de diez sesiones, Claude Code los agrupa en la pestaña Installed bajo el título "Not used recently", y en la ficha muestra cuándo funcionó el plugin por última vez. Aparte, /doctor señala los plugins sin usar junto con su coste en contexto. un conjunto de herramientas sigue siendo un conjunto mientras usted recuerde qué hay en él y para qué.

Actualizaciones. Los catálogos oficiales se actualizan solos y piden ejecutar /reload-plugins; los de terceros, por defecto, no. Una actualización es casi una instalación nueva: el contenido puede cambiar, y conviene volver a abrir la ficha.

Si algo se rompió, incluso durante la propia instalación, la pestaña Errors mostrará la causa. Después: desactivar, reinstalar y, en el peor de los casos, vaciar la caché de plugins e instalar de nuevo. Si el catálogo oficial desapareció de la pestaña Marketplaces, lo recupera /plugin marketplace add anthropics/claude-plugins-official.

10. No solo los plugins

Un skill que el agente, a petición suya, descargó de un repositorio ajeno y dejó en la carpeta del proyecto es el mismo caso, solo que sin catálogo, sin ficha y sin scope. Nadie más que usted va a revisarlo.

Las preguntas son las mismas. De dónde viene. Qué hay dentro: SKILL.md se lee en un minuto, pero se revisa la carpeta entera, incluidos los scripts y los archivos a los que hace referencia. Qué herramientas se permite de antemano: el campo allowed-tools. Ese campo muestra lo que queda aprobado previamente sin una pregunta aparte, no la lista completa de lo que puede pasar. Un skill del repositorio de un servicio externo puede perfectamente permitirse ejecutar comandos, y para un skill que envía algo al exterior es normal. Pero conviene verlo antes de la primera ejecución, no después.

La diferencia con un plugin es una sola. Un skill no tiene ficha, pero todo su contenido está ahí al lado en texto plano, y se puede leer antes de la primera ejecución.

11. Qué hacer antes de cada instalación

Seis pasos, en el mismo orden en que aparecieron en el artículo.

1. Fuente. Catálogo oficial, catálogo de la comunidad o repositorio ajeno: esto marca con cuánta atención mirar lo demás.
2. Contenido. La ficha "Will install"; hooks y MCP significan comandos y salida al exterior, y para ellos hay que abrir la descripción.
3. Coste. "Context cost" en la ficha (en el catálogo oficial) y /context antes y después: el plugin se paga en cada petición que usted hace.
4. Scope. El más estrecho que sirva; el project scope es una decisión también por sus compañeros.
5. Prueba. Una tarea antes y después, y la conclusión sale de su propia prueba, no de la descripción.
6. Decisión. Mantener, desactivar o eliminar; en un par de semanas la pestaña Installed le recordará lo que no ha usado.

La caja con sello se inventó para entregar procedimientos enteros y sin envíos sueltos, y eso funciona en los dos sentidos. Quien recibe la caja mira el sello, abre la tapa y pone en el banco solo lo que hoy necesita.

El panel de plugins y el texto de sus mensajes cambian de una versión a otra; si su pantalla no coincide con lo descrito, guíese por el sentido de las líneas y no por su aspecto exacto.