Plugins en Claude Code: no es nada nuevo, es empaquetar lo que ya sabes

TL;DR Un plugin de Claude Code no es una nueva tecnología. Es un directorio que empaqueta skills, subagents, hooks, MCP servers y configuraciones — todo lo que ya conoces — en un formato instalable y compartible con un solo comando.

Si ves "plugins" y piensas "otra cosa más que aprender", tranquilo. No hay API nueva, ni sintaxis nueva, ni concepto nuevo. Un plugin es literalmente tu directorio .claude/ empaquetado: las mismas skills, los mismos agentes, los mismos hooks. La diferencia es que ahora puedes compartirlo con tu equipo o con la comunidad con /plugin install.

Es como un package.json para configuración de Claude Code: un manifiesto que declara qué contiene y una estructura de directorios que Claude Code sabe leer.

Result — la estructura de un plugin:

mi-plugin/
├── .claude-plugin/
│   └── plugin.json          # Manifiesto: nombre, versión, descripción
├── skills/
│   └── code-review/
│       └── SKILL.md          # Skill con su prompt
├── agents/
│   └── reviewer.md           # Subagent personalizado
├── hooks/
│   └── hooks.json            # Hooks de ciclo de vida
├── .mcp.json                 # Servidores MCP
└── settings.json             # Configuración por defecto

Cómo usarlo

1. Instalar un plugin existente

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

El marketplace oficial de Anthropic es claude-plugins-official. Los equipos pueden crear los suyos propios. Un ejemplo oficial que merece la pena: mcp-server-dev, que hace que Claude te construya un servidor MCP entero.

2. Crear un plugin desde cero

mkdir -p mi-plugin/.claude-plugin

// mi-plugin/.claude-plugin/plugin.json
{
  "name": "mi-plugin",
  "description": "Mis workflows de equipo empaquetados",
  "version": "1.0.0"
}

Añade skills en skills/, agentes en agents/, hooks en hooks/hooks.json. La misma sintaxis que usas en .claude/.

3. Probar en local

claude --plugin-dir ./mi-plugin

Las skills aparecen con namespace: /mi-plugin:skill-name.

Y si ese plugin ya lo tienes instalado, tu copia local pisa a la instalada durante esa sesión, así que pruebas el cambio sin desinstalar nada ni subir la versión.

Y antes de compartirlo con nadie, claude plugin validate te dice qué líneas se van a ignorar al cargar.

4. Convertir configuración existente a plugin

Si ya tienes skills y hooks en .claude/, es copiar y pegar:

cp -r .claude/commands mi-plugin/
cp -r .claude/agents mi-plugin/
cp -r .claude/skills mi-plugin/

Referencia

Documentación oficial: Create plugins