Módulo 6: Subagents: delegar trabajo a agentes especializados

Plugin Marketplace: instalar capacidades en lugar de construirlas

Descripción

Hasta ahora has aprendido a construir capacidades para Claude Code: skills (Módulo 05), hooks (Módulo 05), subagents built-in (cápsula 02), y custom subagents (cápsula 03). Construir desde cero te da control total y te enseña cómo funciona el sistema. Pero también consume tiempo. Hay tareas comunes — code review, generación de tests, análisis de seguridad, integraciones con herramientas — que ya alguien resolvió y publicó.

Para eso existe el Plugin Marketplace: un catálogo oficial de plugins instalables con un solo comando. Un plugin es un bundle reutilizable que puede combinar skills, hooks, custom subagents y MCP servers en un solo paquete. En vez de escribir un skill /code-review, instalas un plugin que ya lo trae con un workflow probado por miles de developers.

Esta cápsula cubre qué es el Plugin Marketplace, el comando /plugin, cómo instalar y gestionar plugins, criterios para decidir entre instalar o construir, y consideraciones de seguridad. No es una review de plugins específicos — el catálogo cambia cada semana — sino el mental model y los workflows para sumarte al ecosistema sin perder control.

Dónde estamos en la guía

Módulo 01: Qué es Claude Code ✅
Módulo 02: Instalación y setup ✅
Módulo 03: CLAUDE.md y memoria ✅
Módulo 04: Workflow agentic ✅
Módulo 05: Skills y Hooks ✅
Módulo 06: Subagents
  ├── 01: Introducción ✅
  ├── 02: Built-in subagents ✅
  ├── 03: Custom subagents ✅
  ├── 04: Plugin Marketplace ← ESTÁS AQUÍ
  └── 05: Introducción a Agent Teams
Módulo 07: Integraciones (Git, SDK, Remote Control)
Módulo 08: Proyecto integrador

Las tres cápsulas anteriores fueron sobre construir capacidades propias. Esta cápsula cierra el círculo: cómo aprovechar lo que la comunidad ya construyó. La cápsula 05 te llevará al frontier (Agent Teams).

Qué es un plugin

Un plugin es un bundle reutilizable que empaqueta una o más capacidades de Claude Code:

┌────────────────────────────────────────────────┐
│              UN PLUGIN PUEDE INCLUIR           │
│                                                │
│  ┌──────────┐   ┌──────────┐   ┌──────────┐    │
│  │  Skills  │   │  Hooks   │   │ Subagents│    │
│  │  (slash  │   │ (eventos)│   │  custom  │    │
│  │ commands)│   │          │   │          │    │
│  └──────────┘   └──────────┘   └──────────┘    │
│                                                │
│  ┌──────────────────┐   ┌──────────────────┐   │
│  │    MCP servers   │   │    Settings      │   │
│  │  (integraciones) │   │   (defaults)     │   │
│  └──────────────────┘   └──────────────────┘   │
│                                                │
└────────────────────────────────────────────────┘

Lo que distingue a un plugin de instalar las piezas sueltas:

Coherencia: Las piezas están diseñadas para trabajar juntas. Un plugin de "test generation" trae el skill /gen-tests, un hook que ejecuta los tests al guardar, y un subagent que analiza la cobertura. Las tres piezas están afinadas entre sí.
Versionado: El plugin se actualiza como una unidad. No tienes que mantener manualmente skills, hooks y subagents por separado.
Distribución: Un solo comando instala todo. Un solo cambio actualiza todo. Un solo comando lo desinstala.

Plugin vs cápsulas anteriores

Mecanismo	Origen	Ámbito
Built-in subagent (cápsula 02)	Anthropic, viene con Claude Code	Universal
Custom subagent (cápsula 03)	Tú lo escribes en `.claude/agents/`	Tu proyecto
Skill (Módulo 05)	Tú lo escribes en `.claude/skills/`	Tu proyecto
Plugin (esta cápsula)	Comunidad o Anthropic, instalado de marketplace	Tu proyecto, tu user, o tu equipo

Plugin = "alguien ya construyó el subagent/skill/hook que necesitas, lo bundlea, y lo distribuye".

El Plugin Marketplace oficial

Anthropic mantiene un marketplace oficial de plugins curados: el repositorio público anthropics/claude-plugins-official. Desde marzo 2026 alberga más de 100 plugins, y crece cada semana.

El marketplace está integrado dentro de Claude Code — no necesitas abrir un sitio externo ni clonar repositorios manualmente.

Cómo acceder

Desde una sesión de Claude Code:

> /plugin

Esto abre la interfaz interactiva del marketplace, con tabs:

Discover: explorar plugins por categoría, buscar por nombre, ver los más instalados
Installed: ver tus plugins activos, configurarlos, actualizarlos, desinstalarlos
Marketplaces: gestionar fuentes de plugins (oficial + alternativas)

Ejemplo: explorar Discover

> /plugin

[Tabs: Discover | Installed | Marketplaces]

DISCOVER
─────────
Categorías:
  📝 Code review            (12 plugins)
  🧪 Testing                (15 plugins)
  🔒 Security               (8 plugins)
  📚 Documentation          (10 plugins)
  🚀 Deployment             (7 plugins)
  🔍 Code analysis          (14 plugins)
  ⚙️  DevOps               (11 plugins)
  🎨 Frontend               (9 plugins)
  🗄️  Backend               (13 plugins)
  ...

[Buscar: ___________]   [Filtrar por: ⭐ Más populares ▼]

Navegas con flechas, presionas Enter para ver detalles de un plugin (descripción, autor, versión, qué incluye, ejemplos de uso, link al repo). Desde ahí lo instalas con un Enter.

El workflow de instalación

1. /plugin → Discover
2. Encuentras el plugin que necesitas (ej. "code-review-pro")
3. Enter para ver detalles
4. Enter sobre "Install"
5. Claude Code descarga el plugin, lo registra, y notifica qué piezas incluye
6. Listo: los nuevos slash commands, hooks y subagents están disponibles

No requiere reiniciar la sesión. Los slash commands del plugin aparecen en /help inmediatamente.

Ejemplo: instalar un plugin de code review

Paso 1: descubrir

> /plugin

[Discover → Code review]

⭐ code-review-pro                   v2.4.1   ★ 8.2k installs
   Comprehensive code review with security, performance, and 
   maintainability checks. Includes /review, /security-audit, 
   and a custom subagent.

   📦 Includes:
      • Skill: /review (general code review)
      • Skill: /security-audit (OWASP-style security check)
      • Subagent: code-reviewer (deep dive)
      • Hook: PreToolUse on Write (lint warnings)

Paso 2: instalar

> [Enter sobre "Install"]

✓ Downloaded code-review-pro v2.4.1
✓ Registered 2 skills: /review, /security-audit
✓ Registered 1 subagent: code-reviewer
✓ Registered 1 hook: PreToolUse on Write
✓ Plugin enabled in current project

Available now in /help and /agents.

Paso 3: usar

> /review src/auth/login.py

[code-review-pro skill se ejecuta]
[Output: review estructurado con 3 issues encontrados, 
 categorizados por severidad]

> /security-audit src/

[code-review-pro skill se ejecuta en modo security]
[Output: análisis OWASP con findings y recomendaciones]

Paso 4: desinstalar (si decides que no lo necesitas)

> /plugin → Installed → code-review-pro → Uninstall

✓ Removed plugin code-review-pro
✓ Unregistered 2 skills, 1 subagent, 1 hook

Total time: 2-3 minutos para instalar, evaluar, y decidir si te sirve.

Cuándo instalar un plugin vs construir el tuyo

No todo merece ser un plugin de la comunidad. Hay casos donde construir lo tuyo es mejor.

Instala un plugin cuando…

✅ La tarea es genérica (code review, test generation, formatting)
✅ Hay un plugin con buena reputación (★ 1k+ installs, autor conocido)
✅ Quieres validar la idea rápido antes de construir lo tuyo
✅ El plugin maneja un caso de uso bien resuelto y estandarizado
✅ Te ahorra horas de configuración manual

Construye tu propio skill/subagent cuando…

❌ La tarea es específica a tu proyecto (convenciones internas, dominio único)
❌ Necesitas control fino sobre cada paso del workflow
❌ El plugin disponible no se ajusta y tendrías que sobrescribirlo casi todo
❌ La lógica involucra secretos, datos sensibles, o compliance interno
❌ No hay plugin que cubra exactamente lo que necesitas

Patrón híbrido: instalar + extender

Lo más común en proyectos maduros: instalar plugins que cubren el 80% del caso, y construir 1-2 skills custom que cubren el 20% específico de tu proyecto.

.claude/
├── agents/
│   └── domain-validator.md       (custom: tu dominio de negocio)
├── skills/
│   └── company-style-check/      (custom: tus convenciones)
└── settings.json
    └── enabledPlugins:
        ├── code-review-pro       (de marketplace)
        ├── test-generator-pro    (de marketplace)
        └── security-audit-base   (de marketplace)

Marketplace para lo genérico, custom para lo específico.

Marketplaces alternativos

El marketplace oficial de Anthropic es el punto de partida, pero existen alternativas curadas por la comunidad. Puedes registrarlas como fuentes adicionales:

Marketplaces conocidos (mayo 2026)

Marketplace	Característica	URL
anthropics/claude-plugins-official	Curado por Anthropic, calidad garantizada	(built-in)
claude.com/plugins	Catálogo web navegable de los oficiales	claude.com/plugins
buildwithclaude.com	Marketplace de la comunidad, 500+ plugins	buildwithclaude.com
claudemarketplaces.com	Directorio de marketplaces y plugins	claudemarketplaces.com
awesome-claude-plugins	Lista curada en GitHub	github.com/Chat2AnyLLM/awesome-claude-plugins

Agregar un marketplace alternativo

> /plugin → Marketplaces → Add new

Marketplace URL: https://buildwithclaude.com/registry.json
Name: Build with Claude

✓ Marketplace agregado. 547 plugins disponibles desde esta fuente.

Recomendación

Empieza con el marketplace oficial. Es lo más seguro y los plugins son revisados. Solo agrega marketplaces alternativos cuando tengas casos de uso que el oficial no cubra y entiendas el riesgo de instalar código de terceros.

Seguridad: qué tener en cuenta antes de instalar

Un plugin puede traer hooks que ejecutan comandos en tu máquina, MCP servers que se conectan a redes externas, y subagents con permisos de escritura. No instales plugins que no entiendas.

Checklist antes de instalar

□ ¿El plugin viene del marketplace oficial?
   → Sí: confianza alta, ya pasó revisión de Anthropic
   → No: revisa el código fuente antes de instalar

□ ¿Cuántas instalaciones tiene? ¿Qué dice la comunidad?
   → 1k+ installs y reviews positivas: señal sólida
   → < 100 installs y autor desconocido: precaución

□ ¿Qué hooks incluye? ¿Qué eventos cubre?
   → Hooks en PreToolUse Bash pueden interceptar comandos arbitrarios
   → Hooks en PostToolUse Write pueden modificar tus archivos sin que veas

□ ¿Qué MCP servers incluye?
   → MCP servers se conectan a servicios externos
   → Verifica qué tokens o credenciales pide

□ ¿El plugin pide permisos elevados?
   → Si pide Bash sin restricciones, evalúa el riesgo
   → Si pide acceso a tu home directory, también

Convención: revisar antes de aprobar

Cuando instalas un plugin, Claude Code te muestra qué piezas incluye y qué permisos requiere. Lee esa lista. Si hay algo que no entiendes, no apruebes — abre el código del plugin (link al repo) y revisa qué hace.

Plugins en proyectos de equipo

Si vas a habilitar un plugin para todo el equipo (a través de .claude/settings.json commiteado al repo), pasa por el flow normal de PR review. Que un teammate verifique qué hace el plugin antes de mergear el cambio.

Patterns comunes

Pattern 1: Stack inicial mínimo

Cuando empiezas un proyecto nuevo, instala 3-4 plugins core y agrega más solo cuando los necesites:

Plugins core para empezar (ejemplos comunes):
  • code-review-pro          → /review en PRs
  • test-generator-pro       → /gen-tests para nueva lógica
  • security-audit-base      → /security-audit periódico
  • doc-generator            → /gen-docs para módulos públicos

Resistir la tentación de instalar 20 plugins "por si acaso". Cada plugin agrega slash commands al autocomplete y hooks al lifecycle — demasiados saturan.

Pattern 2: Plugin + extensión propia

Instala un plugin como base, crea un skill custom que lo extiende para tu proyecto:

1. Instalar code-review-pro (review genérico)
2. Crear .claude/skills/review-our-style/SKILL.md
   description: "Code review siguiendo convenciones de NUESTRA empresa"
   contenido: "Primero ejecuta /review, después agrega checks de:
              - naming en español
              - imports relativos vs absolutos según nuestra convención
              - error messages en formato {code}:{message}"

El plugin hace el heavy lifting. Tu skill personaliza para tu contexto.

Pattern 3: Plugins por equipo, custom por developer

.claude/settings.json (commiteado, equipo)
└── enabledPlugins: [...]   # plugins que todo el equipo usa

~/.claude/settings.json (personal, no commiteado)
└── enabledPlugins: [...]   # plugins que solo tú usas

.claude/skills/ (commiteado, equipo)
└── ...                      # convenciones de equipo

~/.claude/skills/ (personal, no commiteado)
└── ...                      # tus preferencias personales

Equipo comparte plugins core. Cada developer agrega los suyos personales.

Pattern 4: Auditoría periódica

Cada 1-2 meses, revisar plugins instalados:

> /plugin → Installed

Por cada plugin:
- ¿Lo usaste en los últimos 30 días?
   → No: candidato a desinstalar
- ¿Hay actualización disponible?
   → Sí: revisar changelog antes de actualizar
- ¿Sigue activo el plugin?
   → Si lleva 6 meses sin updates, evalúa alternativa

Un marketplace activo evoluciona — los plugins también.

Pitfalls y edge cases

Pitfall 1: confiar ciegamente en el número de installs

Un plugin con 5k installs no es necesariamente seguro. Puede ser popular pero estar desactualizado, abandonado, o tener una vulnerabilidad reciente. Revisa la fecha del último commit y el changelog antes de instalar.

Pitfall 2: conflictos entre plugins

Dos plugins pueden definir el mismo slash command. Por ejemplo, code-review-pro y simple-reviewer ambos pueden registrar /review. Cuando instalas el segundo, Claude Code te avisa y te pide elegir cuál tiene prioridad.

⚠️  Slash command conflict: /review

  - code-review-pro v2.4.1 (already installed)
  - simple-reviewer v0.8.0 (about to install)

  Choose precedence:
  [1] Keep code-review-pro
  [2] Override with simple-reviewer
  [3] Cancel install

Resuelve el conflicto en el momento, no dejes el sistema en estado ambiguo.

Pitfall 3: hooks que ralentizan tu sesión

Plugins con hooks pesados (ej. ejecutar tests completos en cada Write) pueden hacer que cada acción de Claude Code sea lenta. Si notas degradación de performance después de instalar un plugin, revisa sus hooks y considera desactivarlos individualmente.

Pitfall 4: actualizar sin leer el changelog

Una actualización puede cambiar el comportamiento de un slash command que tu equipo ya internalizó. Antes de actualizar, lee el changelog del plugin. Si el bump es mayor (ej. v2.x → v3.0), revisa si hay breaking changes.

Pitfall 5: instalar plugins fuera del marketplace oficial sin revisar

El ecosistema MCP/plugin de Claude Code crece rápido y atrae actores oportunistas. Un plugin de un repositorio personal de GitHub con 3 commits no merece la misma confianza que un plugin oficial. Revisa el código antes de instalar de fuentes no curadas.

Ejemplo completo integrado

Escenario: setup completo para un proyecto Python nuevo

Empiezas un proyecto FastAPI. Quieres tener un workflow de calidad sin escribir 5 skills custom el día 1.

Día 1 — Setup inicial con plugins
─────────────────────────────────

> claude

> /plugin → Discover → "fastapi"

Plugins encontrados:
  ⭐ fastapi-helper       v1.2.0   ★ 3.1k installs
     /endpoint, /pydantic-model, hook para validación

  ⭐ pytest-pro           v4.0.1   ★ 7.5k installs
     /gen-tests, /coverage, subagent test-debugger

  ⭐ security-audit-base  v1.5.2   ★ 5.4k installs
     /security-audit con OWASP, hook PreCommit

> [Install fastapi-helper]
> [Install pytest-pro]
> [Install security-audit-base]

✓ 3 plugins instalados
✓ 7 nuevos slash commands disponibles
✓ 2 nuevos subagents disponibles
✓ 3 hooks activos

Una vez instalados, ya puedes trabajar con el workflow completo:

> "Crea un endpoint POST /api/users que valide email y password"

Claude Code:
  → Usa /endpoint del plugin fastapi-helper
  → Genera el endpoint con validación Pydantic (auto-detectado)
  → Hook PreCommit ejecuta /security-audit en lo nuevo
  → Sugiere /gen-tests para cubrir el endpoint

> /gen-tests src/api/users.py

  → Genera tests con pytest siguiendo el pattern del plugin
  → Subagent test-debugger valida que los tests pasan

Sin construir nada custom, ya tienes un workflow profesional.

Día 30 — Evolucionar con custom skills
───────────────────────────────────────

Después de un mes notás que repetís dos cosas:
  1. Cada nuevo endpoint necesita logging estructurado en formato JSON
  2. Los pydantic models deben heredar de tu BaseModel custom

Esos son patterns ESPECÍFICOS a tu proyecto. Creas skills custom:

.claude/skills/endpoint-with-logging/SKILL.md
.claude/skills/our-pydantic-model/SKILL.md

Ahora Claude usa los plugins para lo genérico (estructura del endpoint)
y tus skills para lo específico (tu logging y tu BaseModel).

Plugins + custom es el patrón ganador.

Ejercicios prácticos

Ejercicio 1: explorar el marketplace

Abre Claude Code en cualquier proyecto y ejecuta:

> /plugin

Navega Discover. Filtra por una categoría que te interese (testing, security, deployment, etc.).

Qué observar

Identifica:

Cuántos plugins hay en esa categoría
Cuáles son los 3 más instalados
Qué incluye cada uno (skills, hooks, subagents, MCP servers)

No instales nada todavía. Solo familiarízate con el catálogo y la información disponible por plugin.

Ejercicio 2: instalar y desinstalar

Elige un plugin del marketplace oficial (ej. uno de utilities o productivity). Instálalo:

> /plugin → Discover → [seleccionas plugin] → Install

Verifica:

Qué slash commands nuevos aparecen en /help
Si trajo subagents, aparecen en /agents
Si trajo hooks, qué eventos cubren

Después, desinstálalo:

> /plugin → Installed → [el plugin] → Uninstall

Verifica que los slash commands, subagents y hooks ya no están.

Qué aprender

El ciclo install/uninstall es 100% reversible. Esto significa que puedes probar plugins libremente — si no te sirve, desinstalas. Sin compromiso a largo plazo.

Ejercicio 3: comparar un plugin vs construir lo equivalente

Encuentra un plugin que incluya un skill que podrías construir tú (ej. un skill de code review).

1. Lee el contenido del SKILL.md del plugin (en su repo)
2. Estima cuánto tiempo te tomaría construir algo equivalente desde cero
3. Compara la calidad del skill del plugin con lo que tú habrías escrito

Qué evaluar

¿El plugin maneja casos que tú no habrías pensado? (edge cases, formatos de output, configurabilidad)
¿Sigue convenciones que tu equipo respeta o las contradice?
¿La diferencia de calidad justifica las horas que ahorras?

A veces vale la pena instalar incluso si tú podrías construirlo, porque el plugin ya está afinado por miles de usuarios. Otras veces tu propio skill — más simple y específico — es mejor.

Ejercicio 4: stack mínimo para tu proyecto

Para un proyecto real tuyo, define un stack mínimo de 3 plugins:

1. ¿Qué tarea repites más frecuentemente que un plugin podría cubrir?
2. ¿Hay un plugin del marketplace oficial que la cubra bien?
3. Repite hasta tener 3 plugins identificados (no más).

Instala los 3, úsalos por una semana, y al final evalúa cuáles seguir usando.

Reflexión

Después de la semana:

¿Cuál usaste más?
¿Cuál no usaste casi nunca? (candidato a desinstalar)
¿Cuál te hizo desear modificar algo de su comportamiento? (candidato a custom skill que extiende el plugin)

Ejercicio 5: auditoría de seguridad

Elige un plugin que NO sea del marketplace oficial (de un marketplace alternativo o de un repositorio público en GitHub).

Antes de instalarlo, revisa:

Quién es el autor (perfil de GitHub, otros proyectos)
Cuándo fue el último commit
Qué hooks incluye y qué hacen
Qué MCP servers incluye y a qué servicios se conectan
Qué permisos pide

Decisión informada

Después de revisar, decide:

¿Lo instalarías en tu máquina personal?
¿Lo instalarías en el repo de tu equipo?
¿Qué te haría cambiar de opinión en cualquiera de los dos casos?

Este ejercicio es la práctica que debes hacer cada vez que instalas algo de fuera del marketplace oficial.

Resumen

Plugin Marketplace es la forma más rápida de sumar capacidades sin construirlas desde cero. El marketplace oficial de Anthropic, integrado en Claude Code via el comando /plugin, te da acceso a más de 100 plugins curados que combinan skills, hooks, subagents y MCP servers.

Lo que aprendiste en esta cápsula:

Un plugin es un bundle de skills + hooks + subagents + MCP servers distribuido como unidad
El comando /plugin abre la interfaz del marketplace con tabs Discover, Installed, Marketplaces
Anthropic mantiene un marketplace oficial (anthropics/claude-plugins-official) con 100+ plugins curados desde marzo 2026
Existen marketplaces alternativos (claude.com/plugins, buildwithclaude.com) — usar con criterio
Cuándo instalar: tareas genéricas, plugins con buena reputación, ahorrar horas de configuración
Cuándo construir: tareas específicas a tu proyecto, control fino, secretos o compliance interno
Patrón ganador: plugins para lo genérico (80%) + skills custom para lo específico (20%)
Seguridad: revisar autor, installs, hooks y permisos antes de instalar — especialmente fuera del marketplace oficial
Conflictos entre plugins se resuelven al instalar (precedencia explícita)

Siguiente cápsula: 05 - Introducción a Agent Teams — el modelo emergente de orquestación multi-agente con team lead, teammates, y task board.

Recursos adicionales

Documentación oficial

Discover and install prebuilt plugins — Documentación oficial del Plugin Marketplace
Plugins Reference — Estructura completa de un plugin (skills, agents, hooks, MCP)
claude.com/plugins — Catálogo web del marketplace oficial

Marketplace y comunidad

anthropics/claude-plugins-official — Repositorio del marketplace oficial
buildwithclaude.com — Marketplace de la comunidad
awesome-claude-plugins — Lista curada de marketplaces y plugins

Crear tus propios plugins

Plugin development guide — Cómo empaquetar tus skills + hooks + agents en un plugin distribuible
Best Practices — Recomendaciones para construir plugins reutilizables

← AnteriorCustom Subagents: crear agentes especializados a medida Siguiente →Introducción a Agent Teams: orquestación multi-agente