Plugins: Empaquetar todo para Distribuir

Ya vimos cuatro formas de darle nuevas capacidades a Claude Code: Skills, Subagentes y Hooks por un lado, MCP por otro. Un plugin no agrega una quinta: es el paquete instalable que agrupa cualquier combinación de las cuatro anteriores —además de binarios propios y servidores MCP/LSP— para compartirla con el equipo o instalarla en otra máquina de una sola vez.

mi-plugin/
├── .claude-plugin/
│   └── plugin.json      # ÚNICAMENTE el manifiesto vive acá
├── skills/               # el resto vive en la RAÍZ del plugin
├── agents/
├── commands/
├── hooks/
│   └── hooks.json
├── bin/                  # ejecutables que se agregan al PATH del plugin
├── .mcp.json
├── .lsp.json
└── README.md

Reglas con las que casi todo el mundo tropieza la primera vez: nada además de plugin.json va dentro de .claude-plugin/ — todo lo demás va en la raíz del plugin. Los binarios de bin/ quedan disponibles como comandos del sistema para el resto de las piezas del plugin mientras está activo. El settings.json de un plugin solo admite el campo agent (a propósito: un plugin no debería poder pisar tu configuración global).

Un plugin tiene sentido cuando ya tenés un conjunto coherente de skills/subagentes/hooks que se usan juntos y querés poder instalarlos con un solo comando en cualquier proyecto o máquina del equipo.

Tres ejemplos de plugins reales, cada uno con un foco distinto:

• superpowers — un conjunto de skills de proceso (brainstorming, debugging sistemático, TDD, escritura de planes) que fuerzan un flujo disciplinado antes de tocar código, en vez de saltar directo a la implementación.
• frontend-design — skills de dirección visual para no caer en el “look” genérico por defecto: tipografía, paleta, layout, con criterio de diseño intencional.
• code-review — el subagente y la lógica detrás de /code-review: revisa un diff o PR en distintos niveles de esfuerzo (de rápido a multi-agente en la nube) y puede aplicar los fixes encontrados.

Documentación relacionada: guía de Plugins para arrancar, y la referencia técnica completa (schema de plugin.json, marketplaces, distribución) cuando ya tengas uno andando.