Skills vs MCP en Claude Code: cuándo usar cada uno y el truco de la divulgación progresiva que casi nadie te explica

Casi todo el que empieza con Claude Code se hace la misma pregunta, y se la hace mal: "¿uso Skills o monto un servidor MCP?", como si fueran lo mismo. Y no lo son. Ni de lejos.

El error tiene consecuencias muy concretas. Usar uno donde tocaba el otro es la diferencia entre que Claude vuele o que se atasque y te funda los tokens a lo tonto. La gente elige por moda o por lo primero que encuentra, sin entender para qué está pensada cada herramienta, y luego se pregunta por qué el asistente va lento o pierde el hilo.

El reencuadre es sencillo: las Skills (habilidades) y los servidores MCP resuelven problemas distintos, y elegir bien es media batalla ganada. Y hay una pieza que casi nadie explica bien y que es la que hace a Claude brutalmente eficiente: los tres niveles de divulgación progresiva.

Te lo desgrano todo: qué son las skills de verdad, sus luces y sus sombras frente al MCP, cuándo te conviene cada uno y cómo funciona ese truco de los tres niveles por dentro.

Qué son las Skills (y por qué se parecen a tu CLAUDE.md)

Las skills llegaron después del MCP, como una innovación más reciente, y empezaron siendo algo exclusivo de Claude Code (hoy ya las adoptan otros LLMs). La idea es simple: son instrucciones en archivos Markdown, muy parecidas al fichero CLAUDE.md que ya conoces (o el AGENTS.md si usas otro agente).

¿La diferencia clave? Que puedes tener muchas skills, como tener muchos CLAUDE.md especializados. Dicho así no suena revolucionario, pero tiene tres gracias enormes:

• Son facilísimas de crear. Cualquiera puede hacerlas: es una carpeta con archivos .md y, si quieres, algún script. Nada de programar servidores.
• Traen divulgación progresiva. No cargan todo el contexto de golpe; solo la cabecera con la información de cuándo son relevantes, y Claude decide si necesita leer el resto. Súper eficiente en tokens.
• Pueden ejecutar scripts. Le dices "aquí tienes un script de bash que puedes lanzar", él lo ejecuta y te devuelve el resultado. Es casi como una herramienta, pero a una granularidad un poco más alta.

Compartirlas es tan fácil como copiar esa carpeta. Y ese es justo el punto donde el MCP se complicaba la vida.

Skills vs MCP: cuándo brilla cada una

Aquí está la comparación honesta, con sus pros y sus contras. Muchos de los que trabajábamos con MCP dimos un suspiro de alivio colectivo cuando salieron las skills, pensando "así es como debería haber sido desde el principio". Pero cada cosa buena tiene su lado malo.

• ✅ Skills: limpias, simples y elegantes. Se construyen y se comparten con solo archivos Markdown, y son muy eficientes en contexto. Frente a ellas, el MCP arrastra mucha "fontanería": un proceso separado, conexiones, andamiaje… demasiada complejidad técnica para casos de uso sencillos.
• ❌ Skills: al ser más simples, renuncias a parte del poder de las herramientas tradicionales. Un MCP te da una firma de función con parámetros en JSON completo, muy detallada; una skill se queda en "ejecuta este script". Además, el discovery, encontrar e instalar skills, es todavía más caótico que el del MCP (que ya era el salvaje oeste), y hoy lo habitual es instalarlas vía plugins.

Otro detalle: decirle a Claude Code qué skill usar es un poco de ensayo y error. Tienes que emplear una terminología que coincida con esa cabecera de la skill, o forzarla con un "usa [nombre de la skill]" (que es algo frágil si no recuerdas el nombre exacto).

La conclusión práctica: para la mayoría de casos, tira de skills. Reserva el MCP para cuando es lo único disponible o necesitas esa granularidad extrema; por ejemplo, un servicio como Polygon.io se conecta por MCP, y herramientas como Context7 tienen skills pero también requieren su servidor MCP, así que a veces necesitas ambos. Todo esto es parte del sistema completo que montamos en el curso de Vibe Coder, donde aprendes a construir software real con IA de principio a fin.

El truco que casi nadie explica: los tres niveles de divulgación progresiva

Esta es la parte más bonita y la razón de que Claude Code no se funda tu ventana de contexto. La divulgación progresiva (progressive disclosure) es una jerarquía de tres niveles que carga la información solo cuando hace falta:

1. Metadatos. El nivel más alto: solo el nombre y la descripción de la skill. Claude lee los metadatos de todas sus skills y, según lo que le pidas, decide cuál necesita sin leer nada más. (Si tienes una skill "malabares" descrita como "te enseña a hacer malabares" y le pides malabares, ahí sabrá que debe abrirla.)
2. Instrucciones. El segundo nivel: la guía completa, tus flujos de trabajo y algún fragmento de código. Tanto o tan poco material como necesites.
3. Recursos y código. El tercer nivel: archivos y scripts (Python, bash…) referenciados desde las instrucciones, que solo se activan si Claude decide que los necesita. Si no, ni se leen.

Esa es la magia: Claude no se lo traga todo de golpe, carga justo lo que necesita cuando lo necesita. La diferencia entre un asistente que va como un tiro y otro que se ahoga en su propio contexto. Dominar este tipo de conceptos es lo que separa al que pelea con la IA del que construye con ella, y es el corazón de nuestra ruta de Inteligencia Artificial.

Cómo se monta por dentro: la arquitectura de carpetas

Lo mejor es que la implementación es casi simplista, lo que llaman una "arquitectura de sistema de archivos": todo se basa en carpetas y ficheros. Existe una carpeta .claude en dos sitios: una en tu directorio home (se aplica a todos tus proyectos) y otra dentro de cada repositorio (se aplica solo a ese proyecto).

Dentro de .claude creas una carpeta skills, y ahí una subcarpeta por cada habilidad. Cada subcarpeta lleva un archivo skill.md con los metadatos arriba y las instrucciones debajo, más los archivos o scripts extra que solo se cargan en ese tercer nivel. Copias esa carpeta al repositorio de otra persona y, al abrir Claude Code, tendrá exactamente la misma skill. Es decir: haces commit en tu repo y, de golpe, todo tu equipo tiene esa habilidad. Como enchufar el cable de Matrix y aprender algo al instante.

Y un detalle muy inteligente: cuando Claude Code ejecuta uno de esos scripts, lo hace por terminal, y el contenido del script y su procesamiento se quedan fuera del contexto. Lo único que vuelve es el resultado. Así no ensucias la ventana con toda la fontanería intermedia.

La idea clave: no es Skills o MCP, es saber cuándo usar cada uno

El giro mental es dejar de ver esto como una guerra de "Skills contra MCP" y empezar a verlo como dos herramientas para dos trabajos. Las skills parecen hoy el enfoque más convincente para equipar a Claude con tu conocimiento y tus flujos, y podrían acabar reemplazando al MCP en muchos casos; pero el MCP sigue siendo insustituible cuando necesitas esa potencia y granularidad extremas.

El antes y el después está en el criterio. Antes: elegir a ciegas, montar un MCP pesado para algo que una skill de tres archivos resolvía, y ver a Claude Code atascarse gastando tokens. Después: skills limpias para lo habitual, MCP para lo que de verdad lo pide, y la divulgación progresiva cargando solo lo justo. Mismo modelo, resultados de otra liga.

Y esto es solo una pieza de un puzle mucho mayor: construir software de verdad con IA, con Claude trabajando contigo como un equipo. Si quieres dejar de pelearte con el modelo y empezar a construir en serio, todo el sistema completo está en el curso de Vibe Coder.

Deja de preguntarte cuál es mejor. Aprende cuándo usar cada uno.