Los 6 mecanismos de extensión de Claude Code que todos confunden

Claude Code ofrece seis formas distintas de ampliar su comportamiento: Skills, Hooks, MCP, Sub-agents, Agent Teams y Plugins. Resuelven problemas diferentes, pero sus límites se difuminan rápido. Este tip te da un modelo mental para distinguirlos.

TL;DR La mayoría de la gente solo necesita Skills y MCP. Añade hooks cuando quieras automatización, sub-agents cuando la ventana de contexto se quede corta, y plugins cuando necesites compartir. Agent Teams es experimental — explóralos cuando los sub-agents no alcancen.

La distinción clave: cada uno responde a una pregunta diferente.

Los 6 mecanismos

1. Skills — Qué debe hacer Claude

Archivos markdown con instrucciones que Claude ejecuta como slash commands o activa automáticamente cuando son relevantes. Prompts reutilizables con estructura: argumentos, frontmatter, ejecución en subagentes.

~/.claude/skills/review/SKILL.md → /review src/App.tsx

Si vas a crear una skill que realmente se invoque y no se quede acumulando polvo, hay 5 reglas que Anthropic publica (descripción "pushy", SKILL.md <500 líneas, evals contra baseline, etc.) — son la guía corta antes de tocar el primer SKILL.md.

2. MCP — A qué puede acceder Claude

Model Context Protocol conecta Claude con herramientas externas: bases de datos, APIs, GitHub, Notion. MCP no le dice a Claude qué hacer — le da manos para llegar fuera de su sandbox. Cuando llegue el momento de instalar los tuyos, empieza por los cinco MCPs que se ganan el slot antes de añadir más.

claude mcp add --transport http notion https://mcp.notion.com/mcp

3. Sub-agents — Quién hace el trabajo

Instancias separadas de Claude que resuelven tareas de forma aislada. Cada una tiene su propia ventana de contexto, herramientas y permisos. Trabajan de forma independiente y devuelven resultados.

"Usa el subagente code-reviewer para revisar el módulo de auth"
→ El subagente trabaja aislado → Devuelve resumen

4. Agent Teams — Quién hace el trabajo, en equipo (experimental)

Múltiples instancias de Claude trabajando como equipo coordinado. A diferencia de los sub-agents, los compañeros se envían mensajes entre sí, comparten lista de tareas y cuestionan los hallazgos del otro.

"Crea un equipo: uno en seguridad, otro en rendimiento, otro en tests"
→ 3 sesiones independientes → Discusión cruzada → Síntesis

Profundizamos en el flag para activarlos, los 4 use cases que recomienda Anthropic y las limitations en el tip dedicado a Agent Teams.

5. Hooks — Cuándo pasan cosas automáticamente

Comandos shell que se disparan en puntos específicos del ciclo de vida: antes de ejecutar una herramienta, después de editar un archivo, al iniciar sesión. Sin IA — automatización pura.

{ "PostToolUse": [{ "matcher": "Write", "hooks": [{ "type": "command", "command": "npm run lint" }] }] }

6. Plugins — Cómo compartes todo

Paquetes distribuibles que agrupan skills, agents, hooks y servidores MCP en una unidad instalable. Piensa en paquetes npm pero para extensiones de Claude Code.

my-plugin/
├── .claude-plugin/plugin.json
├── skills/        ← skills reutilizables
├── agents/        ← subagentes personalizados
├── hooks/         ← automatización del ciclo de vida
└── .mcp.json      ← conexiones a herramientas externas

Desde la 2.1.287 un plugin también puede llevar un mod: funciones JavaScript o TypeScript que corren dentro de Claude Code y dibujan en su interfaz. Lo explico con un caso real en mods en Claude Code.

Comparativa

Para una guía completa de Skills con patrones avanzados, consulta el artículo completo sobre Skills.

Relacionado: Cuándo se carga cada feature en el contexto

Documentación oficial: Skills · MCP · Sub-agents · Agent Teams · Hooks · Plugins