Claude Skills, explicado: qué son realmente, y la letra pequeña sobre planes en la que dos páginas de Anthropic no coinciden

Qué es realmente una Skill, mecánicamente

Quita el marketing y una Skill es un directorio con un archivo obligatorio. SKILL.md lleva un frontmatter en YAML (como mínimo un name y una description) seguido de instrucciones en Markdown. A su alrededor, de forma opcional, hay una carpeta scripts/ con código ejecutable, una carpeta references/ con documentación que Claude solo abre cuando la necesita, y una carpeta assets/ con plantillas, fuentes o iconos para lo que sea que produzca la skill. La propia documentación de la plataforma de Anthropic describe el mecanismo casi de forma literal: el modelo ejecuta el equivalente a bash: cat pdf-processing/SKILL.md. Es una lectura del sistema de archivos, no un primitivo especial de la API.

Lo que hace esto distinto de simplemente pegar un system prompt largo es la divulgación progresiva, y tiene costes reales y documentados en tokens en lugar de una vaga tranquilidad. La documentación de la plataforma de Anthropic lo divide en tres niveles: el Nivel 1, el name y la description de la skill, se carga en cada conversación automáticamente con un coste de unos 100 tokens por skill instalada. El Nivel 2, el cuerpo completo de SKILL.md, se carga solo cuando Claude considera que tu petición coincide con la descripción, y Anthropic lo limita a menos de 5.000 tokens (su guía aparte sobre cómo construir skills da el mismo consejo en menos de 5.000 palabras) precisamente para acotar ese coste. El Nivel 3, cualquier archivo de referencia o script incluido, se carga solo si Claude realmente lo abre, y el código fuente de un script nunca entra en la ventana de contexto, solo lo que imprime en stdout cuando se ejecuta. La propia guía de 32 páginas de Anthropic sobre cómo construir skills usa una analogía de cocina que merece la pena citar directamente: «MCP proporciona la cocina profesional: acceso a herramientas, ingredientes y equipamiento. Las Skills proporcionan las recetas: instrucciones paso a paso».

Dónde funcionan realmente las Skills, y el plan que necesitas

Esta es la parte que merece la pena precisar, porque dos de las propias páginas de Anthropic la describen de forma distinta. El centro de ayuda para consumidores de Anthropic afirma: «Las skills están disponibles para usuarios de los planes Free, Pro, Max, Team y Enterprise. Esta función requiere que la ejecución de código esté activada». La documentación de la plataforma para desarrolladores de Anthropic, que describe la misma función subyacente en términos más técnicos, dice que las skills personalizadas están «disponibles en los planes Pro, Max, Team y Enterprise con la ejecución de código activada», y añade que en claude.ai «no se comparten a nivel de toda la organización ni pueden gestionarlas de forma centralizada los administradores». Free aparece en una frase y desaparece en la otra.

Leyéndolo todo junto, la explicación más probable es que las cuatro skills de documentos preconstruidas de Anthropic, generación de PDF, Word, Excel y PowerPoint, funcionan automáticamente para todo el mundo, incluidos los usuarios Free, mientras que subir y ejecutar tu propia skill personalizada requiere Pro o superior con la ejecución de código activada. Si estás en el plan Free y una skill no aparece donde esperabas, esa es la explicación probable, no un fallo.

Surface              Pre-built doc skills    Custom skills              Sharing model
----------------------------------------------------------------------------------------------
claude.ai              Yes, all plans          Pro/Max/Team/Enterprise    Per-user, no org
                        automatically           + code execution on       admin management
Claude Code             No (own reference       Yes, filesystem-based,    Personal (~/.claude),
                        skill ships instead)    no upload needed          project, or plugin
API                     Yes, via skill_id in    Yes, via /v1/skills       Workspace-wide, all
                        the container param     upload endpoints          members share access
Cowork / cloud          N/A                     Loads skills enabled on   Doesn't read your
sessions                                        your claude.ai account,  local ~/.claude/skills
                                                 synced at session start  unless committed to it
Enterprise (org-wide)   Inherits API behavior   Admins can push skills    Org-wide, automatic
                                                 workspace-wide since     updates
                                                 18 Dec 2025

La fila que merece la pena tener en cuenta es la falta de sincronización. Una skill subida a través del panel de Ajustes de claude.ai no es visible para las llamadas a la API, y una skill subida mediante el endpoint /v1/skills de la API no aparece en claude.ai. Las skills de Claude Code son archivos normales en tu máquina, en ~/.claude/skills/ para uso personal o .claude/skills/ dentro de un repositorio para una skill de proyecto compartida, y una sesión en la nube de Cowork solo ve las que están incluidas en ese repositorio, no lo que tengas en tu portátil. Si construyes una buena skill, cuenta con tener que instalarla de nuevo en cada superficie que uses de verdad, no una sola vez para todas.

Cómo instalar y usar una hoy mismo

• En claude.ai: Ajustes → Funciones (en algunas cuentas aparece como «Capacidades») → Skills, y luego «Explorar skills» para abrir el propio directorio de Anthropic, o «Subir una skill» para añadir una carpeta comprimida que hayas construido o descargado, y actívala.
• En Claude Code: crea ~/.claude/skills/<nombre>/SKILL.md para una skill personal, detectada en vivo sin necesidad de reiniciar, o .claude/skills/<nombre>/SKILL.md dentro de un repositorio para compartirla con tu equipo mediante control de versiones. Las skills oficiales de Anthropic se instalan a través del marketplace de plugins: /plugin marketplace add anthropics/skills, y luego /plugin install document-skills@anthropic-agent-skills. Invoca una skill explícitamente con /nombre-de-skill, o deja que Claude la cargue automáticamente cuando tu petición coincida con la descripción.
• A través de la API: referencia las skills preconstruidas de Anthropic por skill_id (pdf, docx, pptx, xlsx) dentro del parámetro container de una llamada a la Messages API junto con la herramienta de ejecución de código, o sube una personalizada a través de los endpoints /v1/skills de la Console para que la comparta todo el workspace.
• Crear la tuya propia: usa la propia skill skill-creator, la meta-skill de Anthropic para construir skills. Describe en lenguaje sencillo el flujo de trabajo que repites a menudo, y crea un SKILL.md correctamente formateado, sugiere frases de activación para la descripción, y avisa si algún texto es demasiado vago para dispararse de forma fiable. La propia guía de Anthropic plantea esto como un proceso de 15 a 30 minutos una vez que sabes cuáles son tus dos o tres tareas repetidas más habituales.

Skills frente a MCP frente a los GPT personalizados frente a las Gemini Gems

La comparación que realmente aclara qué es una skill es la que hace la propia Anthropic frente a su MCP (Model Context Protocol): «MCP conecta a Claude con servicios y fuentes de datos externos. Las skills aportan conocimiento de procedimiento, instrucciones sobre cómo completar tareas o flujos de trabajo concretos. Puedes usar ambos juntos: las conexiones MCP dan a Claude acceso a herramientas, mientras que las skills le enseñan a usar esas herramientas con eficacia». Mecánicamente, MCP es un protocolo que expone herramientas nuevas, capacidades que Claude genuinamente no podría realizar de otro modo, como llamar a una API privada. Una Skill es contenido de prompt más código opcional que le dice a Claude cómo encadenar llamadas a herramientas que ya puede hacer. Ese es el núcleo honesto del argumento escéptico que se trata más abajo: una skill sin script y sin conexión MCP detrás no puede hacer nada que un prompt puntual suficientemente detallado no pudiera hacer ya. Su valor está en el empaquetado y la reutilización eficiente en contexto, no en una capacidad nueva.

                 Claude Skills             MCP                      Custom GPTs (OpenAI)   Gemini Gems
-----------------------------------------------------------------------------------------------------------
Grants new        No - packages prompting   Yes - exposes new        No - system prompt +    No - saved
capability?       Claude already has        tools/API access         optional Actions        persona/prompt
Invocation        Automatic, matched to     Always-on connection     Manual - pick the GPT   Manual - switch
                  your request's wording    once configured          from a list             into the Gem
Portable across   Yes in spirit (open       Yes, it's a protocol,    No - ChatGPT only       No - Gemini
tools?            agentskills.io standard), works with any MCP                                ecosystem only
                  but doesn't sync accounts client
Entry cost        Pro+ for custom skills,   Varies by server, often  ChatGPT Plus/Team/       Included with
                  code execution required   free/self-hosted         Enterprise               most Gemini plans
Instruction       ~5,000 words recommended  N/A - it's a tool        Knowledge files, no      Reportedly capped
length limit      per SKILL.md              connection, not a prompt hard length limit stated ~4,000 characters

Esa última fila sobre las Gemini Gems merece una salvedad: viene de comparativas de terceros, no de una ficha técnica publicada por Google, así que trata la cifra exacta como una aproximación reportada y no como un límite confirmado.

¿Esto es solo prompting con otro nombre? El argumento escéptico

La crítica pública más sustanciosa es «Claude Skills Considered Harmful» de Sibylline Software, y merece la pena leerla más allá del titular porque el propio autor después matizó parte de ella. Su argumento central: las skills atan tus flujos de trabajo documentados al runtime propio de Anthropic de una forma que hace que migrar fuera de él o auditar el comportamiento sea más difícil que con un simple archivo, y, citado directamente, «no tienes ninguna visibilidad sobre por qué se activó una Skill o cómo influye en el razonamiento del modelo», concluyendo que las Skills eran «una micro-optimización diseñada para fidelizar a los clientes, disfrazada de innovación». La alternativa propuesta era una jerarquía sencilla y versionada de archivos README.md que cualquier modelo pudiera leer, auditable por humanos y no atada al runtime de un solo proveedor.

El artículo lleva su propio añadido, incorporado después de que Anthropic abriera el formato: «Desde que se escribió este artículo, Anthropic ha hecho abierta la especificación de las skills, y Codex ha implementado su soporte. Sigo pensando que las skills están sobrevaloradas, pero ya no son activamente dañinas». El argumento del bloqueo de proveedor era la parte fundamental de la crítica original, y quedó bastante debilitado en cuanto el formato SKILL.md se convirtió en un estándar abierto (agentskills.io) que otras herramientas de agentes, no solo Claude, han empezado a implementar. Lo que sobrevive a esa retractación es el punto más estrecho, y todavía acertado, de la sección anterior: una Skill sin código y sin acceso a herramientas detrás es prompting cargado condicionalmente, no una capacidad nueva, y esa es una limitación que el propio planteamiento de Anthropic reconoce implícitamente en lugar de discutir.

Skills reales que merece la pena conocer, con nombre propio

Anthropic incluye cuatro skills preconstruidas por defecto, generación de PDF, Word, Excel y PowerPoint, es decir, salida genuina en formato nativo en lugar de Markdown formateado para parecerlo. Más allá de esas, skill-creator (la meta-skill para construir skills, que conviene instalar primero) y frontend-design (prompting de calidad de interfaz para tareas de programación) son propias de Anthropic. La API también incluye una skill de referencia de código abierto que mantiene actualizado el uso del SDK en ocho lenguajes.

La capa de comunidad es más grande y más concreta de lo que sugieren las páginas de marketing. El repositorio awesome-claude-skills de ComposioHQ, capturado arriba con 74,5 mil estrellas y 8,6 mil forks hoy, una señal real y comprobable de cuánta atención de desarrolladores tiene este ecosistema, incluye skills con nombre y autoría propios, entre ellas un Changelog Generator que convierte commits de git en notas de la versión orientadas al usuario, un MCP Builder que crea servidores MCP en Python o TypeScript a partir de una descripción en lenguaje sencillo, una biblioteca Brand Build Skills de 59 skills que cubre todo el ciclo de vida de un sitio web, desde el SEO hasta el despliegue, y Sentry Automation, una skill construida por un partner que gestiona incidencias, eventos, proyectos, versiones y alertas de Sentry directamente desde Claude. Una skill de partner relacionada pero distinta, Sentry Code Review, incluida en el propio directorio de plugins de Sentry en lugar de en este repositorio, usa el servidor MCP de Sentry para analizar y corregir automáticamente bugs en pull requests de GitHub usando datos reales de errores en producción.

Una fuente más selectiva es la del desarrollador Suraj Khaitan, «I Tried 100 Claude Skills», que puntuó cada skill que probó según una rúbrica de cinco ejes, uno de ellos la postura de seguridad: si una skill hace llamadas de red sorprendentes o incluye binarios opacos. Su propia tasa de eliminación reportada, sobre su lote personal de un centenar aproximado, no una cifra a escala de toda la industria, fue de en torno al 70% con una puntuación por debajo de 3 sobre 5 en más de dos ejes. Sus favoritas: PDF («la skill que me convenció», gracias a un parser incluido que evita campos de formulario alucinados), DOCX/PPTX/XLSX, skill-creator, que dice que hay que instalar «antes que cualquier otra» skill, mcp-builder, y webapp-testing, una skill de automatización de navegador con Playwright para hacer pruebas de humo de una app web de principio a fin.

Qué se rompe, y la advertencia de seguridad que todo el mundo repite

La propia documentación de la plataforma de Anthropic plantea el riesgo sin rodeos, no como texto de relleno: «Usa Skills solo de fuentes de confianza: las que has creado tú mismo o las que has obtenido de Anthropic… una Skill maliciosa puede hacer que Claude invoque herramientas o ejecute código de formas que no coinciden con el propósito declarado de la skill». Señala en concreto las skills que consultan URLs externas como de mayor riesgo, ya que el contenido obtenido puede llevar instrucciones inyectadas, y advierte de que una skill legítima puede volverse arriesgada más adelante si una dependencia externa de la que depende cambia por debajo. Las pruebas independientes de Khaitan coinciden desde fuera con la misma conclusión: recomienda auditar cada script incluido antes de instalar, fijar las dependencias, aislar la ejecución, y tratar «las insignias de partner como marketing, no como garantía», no como sustituto de leer de verdad el código.

Las cuentas Enterprise tienen una mitigación parcial: Anthropic ofrece un escaneo de contenido de skills, pero solo para subidas a través de claude.ai y Cowork, no para skills subidas a través de la API o la Console. Una skill personalizada de todo el workspace subida por la API no pasa por ese escáner en absoluto.

• El coste de contexto se acumula con el volumen. La propia guía de Anthropic advierte de que, por encima de unas 20 a 50 skills activas al mismo tiempo, la calidad de las respuestas se degrada en la práctica, y recomienda desactivar las skills que no necesites en cada momento en lugar de dejarlas todas activadas.
• Activarse de menos y activarse de más son fallos identificados con soluciones prescritas. Una skill que nunca se activa necesita una description más precisa con más de las frases que la gente realmente escribe; una skill que se activa demasiado a menudo necesita disparadores negativos explícitos («NO usar esto para…») añadidos al mismo campo.
• El contenido de una skill no se actualiza a mitad de sesión. Edita un archivo de skill después de que Claude Code ya lo haya cargado en la conversación actual, y tendrás que volver a invocarla explícitamente para que el cambio surta efecto.
• Los nombres de archivo exactos y los nombres reservados importan. SKILL.md debe escribirse exactamente así, distinguiendo mayúsculas y minúsculas, o la propia guía de resolución de problemas de Anthropic dice que obtendrás «Could not find SKILL.md in uploaded folder». Los nombres de las skills deben ir en kebab-case sin espacios ni mayúsculas, y cualquier nombre que contenga «claude» o «anthropic» se rechaza directamente por estar reservado.

Cuándo no molestarse con las Skills

• Si la tarea es realmente puntual. Empaquetar un prompt en una skill solo compensa cuando, de lo contrario, estarías retecleando las mismas instrucciones en varias conversaciones.
• Si lo que realmente necesitas es una capacidad nueva, no un prompting mejor organizado. Eso es trabajo de un servidor MCP, no de una skill. Instalar una skill no le dará a Claude acceso a un sistema al que ya no pudiera llegar.
• Si estás en el plan Free y quieres una skill personalizada. Según la discrepancia sobre restricción por plan de arriba, la suposición más segura es que las subidas personalizadas necesitan Pro o superior con la ejecución de código activada, aunque una página de Anthropic dé a entender lo contrario.
• Si no puedes o no quieres leer el script incluido en la skill antes de instalarla. La propia guía de seguridad de Anthropic y todos los analistas independientes que de verdad auditaron skills de la comunidad coinciden en este único punto sin excepción.

La gente también pregunta

¿Qué son las Claude Skills?

Una Skill es una carpeta que contiene un archivo de instrucciones SKILL.md obligatorio más scripts, documentos de referencia y plantillas opcionales. Claude carga el nombre y la descripción de la skill en cada conversación automáticamente, y carga las instrucciones completas solo cuando una petición coincide, un mecanismo llamado divulgación progresiva.

¿Las Claude Skills cuestan algo extra, y qué plan necesito?

Las skills de documentos preconstruidas de Anthropic (PDF, Word, Excel, PowerPoint) funcionan en todos los planes, incluido Free. Las skills personalizadas que construyas o descargues requieren Pro, Max, Team o Enterprise con la ejecución de código activada, según la documentación de la plataforma para desarrolladores de Anthropic, aunque el texto del centro de ayuda para consumidores es menos preciso en este punto.

¿Cuál es la diferencia entre una Skill y un servidor MCP?

MCP conecta a Claude con herramientas y datos externos a los que de otro modo no podría llegar, una capacidad genuinamente nueva. Una Skill empaqueta instrucciones sobre cómo usar capacidades que Claude ya tiene, y no otorga ninguna capacidad nueva por sí sola a menos que incluya un script o una conexión MCP.

¿Es seguro instalar Claude Skills desde GitHub?

Solo de fuentes en las que confíes lo suficiente como para haberlas auditado. La propia documentación de Anthropic advierte de que una skill maliciosa puede hacer que Claude ejecute código que no coincide con su propósito declarado, especialmente las skills que consultan URLs externas. Los analistas independientes que probaron docenas de skills de la comunidad recomiendan leer cada script incluido antes de instalar, ya que un número de estrellas en GitHub o una insignia de partner no es una garantía de seguridad.

¿Cuántas Claude Skills puedo tener instaladas a la vez?

La propia guía de Anthropic señala unas 20 a 50 skills activas al mismo tiempo como techo orientativo antes de que la calidad de las respuestas se degrade por la carga de contexto. Desactiva las skills que no estés usando activamente en lugar de dejarlas todas encendidas.

¿Las Claude Skills funcionan en ChatGPT o Gemini?

No, las Skills son un producto específico de Claude, pero el formato SKILL.md subyacente es un estándar abierto (agentskills.io) que otras herramientas de agentes, incluidos algunos productos que no son de Anthropic, han empezado a adoptar de forma independiente.