Skills, subagents, MCP y plugins en Claude Code: cuál elegir

Ahora mismo, en Claude Code hay cinco formas de hacer la misma revisión de código: un comando slash, un skill, un subagent, un plugin o simplemente un prompt en el chat. Y ninguna es mejor que las demás por defecto: la elección depende de la tarea, el presupuesto de tokens y quién más vaya a usarla.

Esta es la guía que me habría dado a mí mismo hace un año. Un árbol de decisión de 4 preguntas, una matriz lista para usar de «tarea → capa» y 5 errores comunes que hacen gastar tokens a todos los vibe coders con quienes trabajo.

Para saber cómo trabajar con el servicio, consulta la documentación de Ailoot.

¿Para qué sirven los skills, subagentes, MCP y plugins en Claude Code?#

Antes de elegir, distingamos los términos. Las cuatro capas tienen un objetivo: ampliar lo que Claude puede hacer de serie. Pero cada capa tiene su propia naturaleza.

Skill es un directorio con un archivo SKILL.md que describe cuándo y cómo aplicar una metodología concreta. Anthropic compara un skill con las instrucciones para un empleado nuevo: no le dictas cada paso todos los días; le das un procedimiento.

Subagent es una sesión de Claude independiente, con su propio contexto, que se inicia desde la conversación principal. Tiene una característica clave: el aislamiento. Un subagent puede leer 30 archivos, elaborar un resumen y devolver solo eso al chat principal. El contexto de la conversación principal se mantiene limpio.

MCP (Model Context Protocol) es un estándar abierto de Anthropic para conectar Claude con sistemas externos. En una entrada de blog del 13 de noviembre de 2025, Anthropic explicó la diferencia con la máxima claridad:

Plugin es un conjunto listo para usar de skills, subagents, hooks y comandos, creado por otra persona y empaquetado en un marketplace. Instálalo con una sola línea mediante /plugin install y lo obtienes todo de una vez. Si un skill es tu propio procedimiento, un plugin es un procedimiento comprado a otra empresa.

En resumen, los skills son recetas, los subagents son colegas especializados y MCP proporciona herramientas externas a través de las cuales Claude puede acceder a servicios y datos. El coste en tokens varía: un skill es lo más barato (se carga cuando se activa), mientras que MCP es considerablemente más caro (cada servidor conectado ocupa espacio constantemente en la ventana de contexto).

¿Por qué hay 4 capas si puedes usar un único CLAUDE.md?#

En el proyecto descrito, CLAUDE.md es un gran mapa de reglas: dónde va cada cosa, cómo publicar y qué acuerdos están en vigor. Sin este archivo, Claude empezaría de cero cada sesión nueva.

Pero CLAUDE.md tiene un límite. Lo explicaré con tres situaciones en las que deja de funcionar.

Situación 1: una regla solo funciona a veces. CLAUDE.md dice: «ejecuta siempre npm run build antes de git push». Claude lo lee al principio de la sesión, asiente, empieza a escribir código después de 25 mensajes y se olvida. Ya me he sorprendido tres veces haciendo push sin ejecutar el build; esos pushes fallaron en producción. Un hook bien configurado y probado puede ejecutar una comprobación determinista y rechazar la operación cubierta. Su alcance depende del evento y herramienta: un hook de Claude Code no intercepta por sí solo todo push desde otra terminal o aplicación. Verifica que una compilación deliberadamente fallida bloquee la vía que realmente usas.

Situación 2: un proceso de 15 pasos que se repite. En el ejemplo descrito, cada guía pasa por 14 etapas: investigación → estructura → MDX → 7 comprobaciones QA en paralelo → publicación en producción → IndexNow. Si escribo un prompt cada vez que diga «ejecuta la etapa 1, luego la 2 y después la 3», gastaré tokens antes incluso de empezar. Por eso todo este flujo de trabajo está empaquetado en el skill build-masterskaya-guide: un conjunto de instrucciones de 34 KB que se inicia con la frase «vamos a crear una guía nueva para el proyecto».

Situación 3: una tarea devora el contexto. Para comprobar si una guía ya publicada está actualizada, Claude tiene que leer una transcripción de livestream de 30 KB, 20 retrospectivas de 5 KB cada una y compararlas con el sitio actual. Si lo hago en el chat principal, al terminar la revisión tendré 200K tokens de información inútil en el contexto. Un subagent hace el mismo trabajo, devuelve un resumen de solo 300 palabras a la conversación principal y termina.

Situación 4: quiero que el equipo tenga las mismas plantillas que yo. Un conjunto de reglas listas para usar para diseño frontend, hooks para publicar mediante Coolify y MCP para las comprobaciones de Playwright. Eso es un plugin: empaqueto mi configuración, la publico en el marketplace y un compañero la instala con una sola línea.

CLAUDE.md cubre lo básico: «así hacemos las cosas aquí». Las 4 capas adicionales cubren lo que CLAUDE.md no puede hacer físicamente: repetir acciones mediante activadores, aislar el contexto, acceder al mundo exterior y compartir.

¿Cuándo necesitas un skill en vez de CLAUDE.md?#

La prueba para saber si necesitas un skill es sencilla: te descubres copiando el mismo prompt largo de tus notas al chat. La tercera vez ya es una señal.

Ahora tengo 7 directorios en ~/.claude/skills/: build-masterskaya-guide, build-vc-spoke, build-reel-script, build-practicum-instruction, update-config, simplify y keybindings-help. El que más uso es build-masterskaya-guide (este artículo se escribió con él). Contiene 34 KB de metodología: qué etapas seguir, qué comprobaciones QA multiagente ejecutar, qué condiciones de control deberían detener el proceso y qué artefactos guardar en /tmp/.

Cuándo no crear un skill.

• Una regla como «responde en el idioma que prefiere el usuario» va en CLAUDE.md, no en un skill. Un skill se carga cuando se activa, pero esta regla debería aplicarse siempre.
• Una instrucción puntual como «ejecuta el refactor ahora» va en el chat, no en un skill.
• Una tarea que necesita otro contexto puede usar un subagente; si sigue un procedimiento recurrente, conserva la metodología en una skill.

El principal antipatrón. El error más frecuente de los vibe coders es meter un procedimiento en un subagent cuando debería ser un skill. Un subagent cuesta más tokens (tiene su propio contexto), tarda más en iniciarse y suele ser excesivo. Si la metodología de una tarea cabe en 1.500–2.000 palabras sin leer archivos externos, es un skill.

En la guía Skills de Claude Code en 2026: cómo crear una biblioteca personal de Skills encontrarás cómo estructurar un skill, qué incluir en el frontmatter y qué frases de activación funcionan.

¿Cuándo necesitas un subagent en vez de un skill?#

Un skill almacena la metodología; un subagent hace el trabajo. Son capas distintas, a menudo confundidas porque ambas se inician «desde el chat».

Un subagent solo tiene sentido para aislar el contexto. La sesión principal de Claude tiene un presupuesto de 200,000 tokens (o 1 millón en beta). Si le pides en el chat principal que lea 30 archivos y analice cada uno, gastarás la mitad de la ventana en la lectura intermedia. Un subagent hace el mismo trabajo en una sesión aparte y devuelve solo el resultado al chat principal.

Un ejemplo concreto de proyecto. Cada guía pasa por varias comprobaciones QA en paralelo: estilo, citas y hechos contrastados con fuentes primarias, estructura para motores de búsqueda e integridad de los enlaces internos y externos. Cada comprobación requiere su propio contexto: un glosario de reglas, WebFetch para decenas de URL y búsquedas en el texto.

Si ejecutara todas estas comprobaciones en un solo chat, el contexto me consumiría antes de que terminara la primera. Iniciar subagents en paralelo con run_in_background: true lo resuelve: trabajan en segundo plano, el chat principal sigue avanzando y, al cabo de 4–6 minutos, recibo informes concisos y aplico los cambios.

Un segundo ejemplo: investigación intensiva. Cuando elijo un tema para una guía nueva, 4 subagents recopilan señales en paralelo:

• V1 - foros y comunidades durante 14 días
• V2 - redes sociales
• V3 - plataformas de vídeo + blog de Anthropic
• V4 - oportunidades SEO

Cada uno devuelve 30–40 elementos con puntuaciones de viralidad. Los reúno en un conjunto, los pondero según 9 dimensiones y elijo el mejor. Sin subagents, esta etapa se alargaría 2–3 horas y consumiría el contexto principal.

Cuándo no crear un subagent.

• Una tarea que no requiere leer archivos ni usar WebFetch va en el chat principal.
• Un procedimiento repetible pertenece a una skill, pero puede ejecutarse dentro de un subagente si conviene aislarlo.
• El acceso externo requiere herramientas autorizadas como MCP o CLI; un subagente puede usarlas al recibir la tarea.

El principal antipatrón. Crear un subagent llamado backend-engineer o qa esperando que Claude descubra cuándo usarlo. Los subagents específicos (como migration-test-writer o api-route-reviewer) ofrecen una calidad mucho mayor que los genéricos. Cuanto más precisos sean el nombre y las instrucciones del subagent, más acertadamente elegirá Claude el indicado.

En la guía Subagents de Claude Code en 2026: una guía paso a paso encontrarás cómo crear subagents para tareas específicas, la sintaxis del frontmatter y 5 ejemplos listos para usar.

¿Cuándo necesitas MCP en vez de un skill o un subagent?#

Anthropic dio la fórmula más breve para explicar la diferencia en una entrada de blog: MCP conecta Claude con los datos; los skills enseñan a Claude qué hacer con ellos.

Una skill de revisión GitHub necesita el contenido de la incidencia. Aporta acceso mediante MCP o CLI autorizados, o texto suministrado. La skill define después cómo revisar y estructurar hallazgos; MCP por sí solo no prescribe el método.

Mi conjunto específico de MCP.

• Playwright MCP - QA visual de cada guía. Abrir la página en escritorio y móvil, comprobar el ancho del contenedor y si se han renderizado los bloques.
• Stitch MCP - acceso al sistema de diseño y generación de componentes con el estilo de la marca.
• vidIQ MCP - análisis de tendencias y comprobación del potencial viral de las ideas.
• Railway MCP - gestión de la infraestructura de despliegue.

Cada uno de estos 4 servidores es un puente hacia un sistema externo. Sin MCP, tendría que escribir mi propio código wrapper o cambiar a un navegador. Con MCP, todo sucede dentro de la sesión de Claude.

Coste en tokens. MCP es la capa más cara. Cada servidor conectado ocupa espacio constantemente en la ventana de contexto: declaraciones de herramientas, esquemas de argumentos y descripciones. Tengo 4 servidores MCP; eso supone alrededor de 8–12K tokens en cada sesión nueva antes de haber preguntado nada.

Esto significa que solo conectamos MCP si realmente lo necesitamos en la mayoría de las sesiones. Si usas Sentry MCP una vez a la semana, es mejor activarlo cuando haga falta con el flag --mcp sentry en lugar de mantenerlo en la lista permanente.

Cuándo no usar MCP.

• La metodología para «trabajar con datos» va en un skill, no en MCP.
• Una lectura larga puede beneficiarse de un subagente; si algunos archivos o registros son externos, también puede necesitar MCP.
• Publicar con un solo comando requiere un hook o un plugin, no MCP.

El principal antipatrón. Crear un servidor MCP para algo que un skill resolvería mejor. Vi un ejemplo en una discusión de HN (aquel mismo hilo con 422 puntos el 27 de mayo): el autor escribió un servidor MCP que proporcionaba «instrucciones para revisar código». Pero eso no es acceso al mundo exterior, sino un procedimiento. Un skill hace lo mismo con 10 veces menos tokens.

Un incidente por competencia por recursos. Una vez Playwright MCP se quedó bloqueado con el error «Browser is already in use»: tenía una ventana de Chrome abierta al mismo tiempo y MCP no podía hacerse con el control del navegador. Esta es una lección importante: un servidor MCP utiliza recursos del sistema compartidos. Si un recurso está en uso por varios procesos (un navegador, un puerto o un archivo), piensa en el aislamiento desde el principio.

Tienes una guía lista para conectar 7 MCP funcionales en Servidores MCP de Claude Code en 2026: 7 configuraciones listas para usar.

¿Cuándo necesitas un plugin en vez de un skill o un subagent?#

Los skills, los subagents y MCP tratan sobre tu metodología. Un plugin es la metodología lista para usar de otra persona que importas a tu configuración.

En octubre de 2025, Anthropic lanzó Claude Code Plugins, un mecanismo oficial de distribución. Un plugin es un directorio que puede contener:

• sus propios comandos slash
• sus propios skills
• sus propios subagents
• sus propios hooks
• sus propias configuraciones MCP
• sus propios estilos de salida

Todo esto se empaqueta en un solo paquete con plugin.json. La instalación se hace con una línea en ~/.claude/settings.json o con el comando /plugin install <name>.

Mi conjunto específico de plugins.

• frontend-design de claude-plugins-official, el marketplace oficial: 67 estilos, 96 paletas, 57 pares de fuentes y 13 frameworks. Cuando creo un bloque nuevo para el sitio o una plantilla de correo electrónico, cargo este plugin y obtengo toda la biblioteca de una vez.
• playwright del mismo marketplace oficial: un conjunto de skills y configuraciones MCP para pruebas de navegador.
• telegram: un conjunto listo para gestionar una cuenta de Telegram desde Claude Code (política, lista de permitidos, vinculación).
• trailofbits/skills: un conjunto de skills de seguridad de Trail of Bits, una empresa en la que confío para asuntos de seguridad.

Los 4 plugins ocupan tres líneas en settings.json. Sin plugins, pasaría horas creando a mano la misma biblioteca.

Cuándo no usar un plugin.

• Si la metodología es completamente tuya y no está pensada para otras personas, consérvala como skill.
• Si todavía no sabes quién la usará, pruébala primero tú mismo como skill.
• Si necesitas poner rápidamente tres archivos en una máquina nueva, basta con cp ~/.claude/skills/X /new/machine/.claude/skills/.

El principal antipatrón. Usar un plugin para reemplazar CLAUDE.md, por ejemplo, con reglas sobre «cómo hacemos las cosas en este proyecto». Un plugin está pensado para distribuir y reutilizar. Si las reglas son específicas de un solo repositorio, van en CLAUDE.md, no en un plugin.

De cara a 2026, Anthropic avanza claramente hacia un marketplace de plugins para equipos. Eso permitirá que las empresas publiquen sus metodologías internas como plugins, les asignen versiones y las actualicen para todos los empleados con un solo comando. Para un emprendedor individual, eso significa: instala lo que ya está listo y no reinventes la rueda.

Árbol de decisión: 4 preguntas que debes hacerte antes de cada tarea#

Pregunta 1: ¿hay un procedimiento repetible que merezca conservarse?

Empaqueta la metodología como skill en SKILL.md, con una descripción clara de cuándo usarla. Aporta procedimiento, no acceso externo ni contexto separado por sí sola.

Pregunta 2: ¿conviene contexto separado o un rol delegado concreto?

Usa un subagente con tarea y herramientas precisas. Puede seguir la metodología de una skill dentro de ese contexto aislado.

Pregunta 3: ¿se necesitan herramientas o datos externos?

Da acceso autorizado mediante MCP u otra herramienta adecuada, como una CLI ya configurada. La skill explica cómo usarlo; el subagente puede ser quien lo utilice.

Pregunta 4: ¿debe distribuirse y mantenerse como paquete?

Usa un plugin para distribuir skills, definiciones de agentes, hooks o configuración MCP. Puede ser propio o de otro autor.

Ejemplo combinado: revisión recurrente de incidencias GitHub. Una skill define método y formato; GitHub MCP o CLI configurados dan acceso autorizado; un subagente puede leer un hilo largo en su contexto y devolver hallazgos. Un plugin distribuye la combinación al equipo. Las cuatro respuestas pueden ser «sí» sin anularse.

5 errores al elegir capas que cometen los vibe coders#

Veo estos 5 patrones cada semana entre los vibe coders con quienes trabajo. Una de cada dos personas comete al menos uno durante su primera semana.

Error 1: subagent en vez de skill.

Síntoma: un autor creó un subagent para «escribir una entrada nueva en el blog». Cada vez que lo ejecuta, el subagent se carga, lee 2 KB de metodología, genera una entrada y termina. Al cabo de una semana, el autor observa que cada ejecución consume 5K tokens adicionales para cargar el subagent.

Qué debería ocurrir: «cómo escribir una entrada» es una metodología, así que corresponde a un skill. El activador es la frase «entrada nueva para el blog». El skill se carga en el chat principal y no abre una sesión aparte. Cuesta entre 3 y 5 veces menos.

Error 2: servidor MCP en vez de skill.

Síntoma: un autor escribió un servidor MCP que proporciona instrucciones sobre «cómo hacer una revisión de código». Las declaraciones de herramientas, las descripciones de los esquemas de argumentos y la documentación ocupan contexto constantemente. Cada solicitud desperdicia 2–3K tokens en nada.

Qué debería ocurrir: «cómo hacer una revisión de código» es un procedimiento, no un acceso a un sistema externo. Usa un skill. MCP solo se justifica si necesitas acceso en directo, por ejemplo, a Sentry para recuperar los errores más recientes.

Error 3: plugin en vez de CLAUDE.md.

Síntoma: un autor empaquetó en un plugin las reglas del proyecto («usa siempre el modo estricto de TypeScript», «no uses guiones», «usa solo pnpm, no npm») y lo instaló. Ahora, cada sesión nueva carga un plugin que duplica lo que debería estar en CLAUDE.md.

Qué debería ocurrir: las reglas de un proyecto van en el CLAUDE.md de ese proyecto. Un plugin sirve para una metodología que se puede compartir con varias personas o aplicar en varios repositorios.

Error 4: intentar crear un skill mediante un hook.

Síntoma: un autor vio que un hook se ejecuta automáticamente cuando ocurre un evento (por ejemplo, antes de guardar un archivo). Decidió crear un «skill mediante un hook» para que Claude aplicara automáticamente la metodología en cada edición. Obtuvo un bucle infinito de activación, consumió contexto y generó un comportamiento imprevisible.

Qué debería ocurrir: un hook es código determinista que ejecuta un comando, da formato al resultado o bloquea una operación. Un hook no carga un skill ni invoca a Claude. Si necesitas «aplicar siempre la metodología X», usa un skill con un activador o una entrada en CLAUDE.md.

Error 5: añadir una capa cuando no hace falta ninguna.

Síntoma: un autor oye hablar de los skills, lee guías, decide «necesito empaquetar esta metodología» y se pasa una tarde creando un skill para una tarea que surge una vez al mes.

Qué debería ocurrir: una tarea puntual se hace directamente en el chat, cuando surge. Un skill solo se justifica si haces eso más de una vez al día. De lo contrario, es una complicación innecesaria que luego hay que mantener.

Comprueba independientemente procedimiento, aislamiento de contexto o rol, acceso a herramientas y distribución. Añade cada capa con propósito concreto y combínalas cuando la tarea necesite varias.

Qué dice Anthropic sobre la fragmentación: hacia dónde se dirige Claude Code en 2026#

Qué significa esto para los próximos seis meses o un año.

Primero: los skills se están convirtiendo en la capa principal para las tareas procedimentales. Anthropic apuesta claramente por esta capa porque es la más barata y previsible. Si no entiendes por qué necesitas un skill en 2026, estúdialo primero. Todas las demás capas girarán en torno a él.

Segundo: los subagents se están especializando. Su función principal es aislar el contexto para tareas pesadas. Los subagents genéricos como qa-engineer desaparecerán; los específicos como migration-test-writer y api-route-reviewer seguirán existiendo.

Tercero: los nuevos anuncios de Anthropic en un plazo de 14 días —el comando /workflows (28 de mayo de 2026) para orquestar decenas de subagents y la separación de la facturación del Agent SDK a partir del 15 de junio— significan que el uso programático está pasando a un grupo aparte. Es una señal de que Anthropic está creando infraestructura para sistemas automatizados de 10+ agentes en vez de para sesiones individuales.

Para un vibe coder en 2026, esto significa algo sencillo: las cuatro capas durarán al menos otros seis meses y, después, algunas se fusionarán. Pero el árbol de decisión de cuatro preguntas seguirá funcionando tras la fusión: trata sobre la naturaleza de la tarea, no sobre el nombre concreto de la capa.

Matriz lista para usar: 10 tareas habituales → la capa adecuada#

La regla principal para usar esta tabla es no intentar «hacer las 10 cosas a la vez». La mayoría de los vibe coders que trabajan por su cuenta se apañan con CLAUDE.md + 5–7 skills + 2–4 servidores MCP. Los subagents y los plugins se añaden a medida que crece el proyecto.

Qué viene después: cómo construir tu espacio de trabajo en Claude Code#

Estas cinco capas no se suceden unas a otras, sino que encajan entre sí. CLAUDE.md es la base del proyecto y las otras cuatro se incorporan a medida que las tareas crecen.

Conoce Ailoot.