Cómo instalar skills de Claude: Code, Desktop y Web

Instalar un skill de Claude en Claude Code lleva tres comandos:

git clone https://github.com/anthropics/skills
cp -r skills/document-skills/docx ~/.claude/skills/
# restart Claude Code — skills are scanned at startup

Eso es toda la instalación. La carpeta acaba en ~/.claude/skills/, Claude lee el SKILL.md que hay dentro en el siguiente arranque, y a partir de ahí el skill se activa automáticamente cuando aparece una tarea que encaja.

Si siempre fuera tan fácil, este artículo terminaría aquí. No termina, porque la instalación es la parte fiable. Lo que falla es todo lo de alrededor: carpetas anidadas de más, reinicios olvidados y, sobre todo, skills que se instalan perfectamente y luego nunca se disparan. De los skills que hemos testeado para el catálogo de SkillProof, alrededor del 45% tenía algún problema de activación de serie. Instalamos y ejecutamos cada skill antes de listarlo, así que esta guía está construida a partir de esos registros de pruebas, no de leer READMEs.

Si todavía no tienes claro qué es exactamente un skill (frente a un servidor MCP o un system prompt), lee primero qué son los skills de Claude y vuelve. Esta guía asume que ya tienes uno elegido y quieres que funcione.

Qué necesitas antes de instalar

La lista es corta.

Para Claude Code necesitas Claude Code 2.x instalado y git en tu PATH. Ya está. Los skills son carpetas normales con markdown dentro; no hay gestor de paquetes, ni paso de build, ni resolución de dependencias. La única excepción son los skills que llaman a herramientas externas. Webapp Testing necesita Playwright instalado en local, y por eso sacó un 4/5 en facilidad de instalación en nuestras pruebas en lugar de un 5/5. La página del skill te avisará de requisitos así; el propio skill muchas veces no lo hace hasta que falla a mitad de tarea.

Para Claude Desktop y claude.ai necesitas un plan de pago (Pro, Max, Team o Enterprise) y la ejecución de código activada en los ajustes, porque ahí los skills corren dentro del sandbox de ejecución de código. También necesitas el skill como archivo zip en lugar de como carpeta. Más sobre esto abajo.

Una cosa que no necesitas: confiar en el README. Los autores describen lo que esperaban que hiciera el skill. Antes de instalar nada de un repo desconocido, abre su SKILL.md y échale un vistazo. Es el skill entero. Si las instrucciones se ven flojas o la descripción del frontmatter es una frase vaga, acabas de ver un adelanto de tus problemas de activación.

Instalar skills en Claude Code

Cada skill es una carpeta que contiene un archivo SKILL.md, opcionalmente con archivos de referencia y scripts al lado. Instalar significa poner esa carpeta en uno de dos sitios.

Global vs proyecto: la carpeta de skills de Claude Code

La carpeta global es ~/.claude/skills/. Los skills que están aquí quedan disponibles en todos los proyectos de tu máquina. Es el hogar correcto para skills de propósito general: generación de documentos, disciplina de debugging, ayudas de escritura. Nuestra opinión: el 80% de lo que instales va aquí, porque la mayoría de skills codifican una capacidad, no una convención de proyecto.

La carpeta de proyecto es .claude/skills/ dentro de un repositorio. Los skills que están aquí solo se activan dentro de ese proyecto. Úsala para convenciones de equipo, configuración específica del proyecto o cualquier cosa que quieras que tus compañeros reciban automáticamente, porque los skills de proyecto viajan con el repo. Alguien lo clona y ya tiene los skills. Sin documento de onboarding.

Cuando el mismo nombre de skill existe en ambos sitios, gana la copia del proyecto. Eso es una funcionalidad (un proyecto puede sobrescribir tus valores globales) y, de vez en cuando, un bug en el que perderás veinte minutos, que cubrimos en la sección de solución de problemas.

Rutas en macOS, Windows y Linux

macOS y Linux usan la misma ruta: ~/.claude/skills/ para lo global, <project>/.claude/skills/ para el ámbito de proyecto. En macOS eso se expande a /Users/<you>/.claude/skills/; en Linux, a /home/<you>/.claude/skills/.

En Windows la carpeta global es %USERPROFILE%\.claude\skills\, que normalmente significa C:\Users\<you>\.claude\skills\. En PowerShell, ~ se resuelve igual, así que ~\.claude\skills\ también funciona ahí. Fíjate en que la carpeta empieza con un punto en todas las plataformas. El Explorador de Windows la oculta por defecto y el Finder de macOS también (pulsa Cmd+Shift+. para mostrar los archivos ocultos), y por eso recomendamos hacer las instalaciones desde la terminal aunque vivas en la interfaz gráfica.

La estructura final tiene que ser exactamente esta:

~/.claude/skills/
  docx/
    SKILL.md
  frontend-design/
    SKILL.md

Carpeta del skill, y SKILL.md directamente dentro. No skills/docx/docx/SKILL.md. Ese doble anidamiento es el error de instalación más común que vemos, y Claude falla en silencio: sin errores, el skill simplemente no existe para Claude.

Cómo instalar un skill de Claude desde GitHub

La mayoría de skills viven en GitHub, normalmente varios por repo. El patrón es: clona el repo en algún sitio temporal, copia la carpeta que quieres a tu directorio de skills y borra el clon si quieres.

Aquí tienes un ejemplo real con el repo oficial de Anthropic, instalando DOCX, el skill de documentos de Word que sacó un 9/10 en calidad de output en nuestras pruebas:

git clone https://github.com/anthropics/skills
cp -r skills/document-skills/docx ~/.claude/skills/

Reinicia Claude Code. Listo. El mismo repo trae Frontend Design, el skill con mejor puntuación de nuestra categoría de diseño (10/10 en output; la diferencia de antes y después en trabajo de UI es la mayor que hemos medido):

cp -r skills/frontend-design ~/.claude/skills/

Fíjate en que las rutas difieren: document-skills/docx está anidado un nivel más profundo que frontend-design. Los repos organizan los skills como al autor le apeteció ese día. Comprueba siempre dónde está realmente el SKILL.md y copia la carpeta que lo contiene directamente. Cada ficha de nuestra categoría de documentos y del resto del catálogo muestra el comando de copia exacto ya rellenado, porque nos cansamos de deducir estas rutas a mano.

¿No tienes git? Descarga el zip del repo desde GitHub (Code → Download ZIP), extráelo y mueve la carpeta del skill a su sitio. Mismo resultado, más clics.

Marketplaces de plugins

Algunos autores distribuyen a través del sistema de plugins de Claude Code en lugar de carpetas sueltas:

/plugin marketplace add obra/superpowers-marketplace
/plugin install superpowers

Ese es el comando de instalación real de la colección Superpowers, hogar de Test-Driven Development, que sacó un 9/10 en output en nuestras pruebas y un 5/5 en fiabilidad de activación. Los plugins gestionan las actualizaciones por ti, cosa que las copias de carpetas no hacen, y en nuestra experiencia la distribución por plugin correlaciona con disciplina de mantenimiento: un autor que montó un marketplace tiende a ser un autor que publica arreglos. Cuando un skill ofrece ambas vías de instalación, elige el plugin.

Instalar en Claude Desktop y claude.ai

Claude Desktop y claude.ai no leen tu sistema de archivos, así que el método de la carpeta no aplica. En su lugar, subes el skill como zip a través de los ajustes de capacidades.

Los pasos, vigentes a mediados de 2026:

1. Comprime la carpeta del skill de forma que SKILL.md quede en el nivel superior dentro del archivo (comprime la carpeta en sí, no su carpeta padre).
2. En Claude Desktop o claude.ai, abre Ajustes y luego Capacidades.
3. Activa la ejecución de código si no está ya activada. Sin ella, los skills ni siquiera aparecen como opción.
4. En Skills, elige subir y selecciona tu zip.

El skill queda entonces disponible en conversaciones nuevas. Los skills curados de Anthropic (el set de documentos, principalmente) también pueden activarse directamente en esa misma zona de ajustes sin subir nada, y si el skill que quieres está ahí, usa el interruptor. Está versionado y mantenido por ellos.

Dos advertencias honestas de nuestras pruebas. Primera: los skills que ejecutan herramientas locales obviamente no pueden hacerlo en el sandbox de claude.ai; un skill que maneja Playwright o lee tu historial de git es un skill de Claude Code, punto. Segunda: las instalaciones por subida son por cuenta, no por máquina, lo cual es cómodo justo hasta que estás manteniendo versiones distintas en Claude Code y claude.ai y obteniendo comportamientos diferentes del "mismo" skill. Si trabajas en ambos, mantén Claude Code como fuente de verdad y vuelve a comprimir cuando actualices.

Cómo verificar que el skill realmente se activa

Este es el paso que casi todo el mundo se salta, y es donde las instalaciones fallan de verdad. Un skill puede estar perfectamente colocado, perfectamente formateado, y no activarse ni una vez, porque la activación depende de que Claude case tu petición con el campo description del frontmatter del skill. Si esa descripción es vaga, el skill es un mueble.

Testeamos la fiabilidad de activación de forma explícita, y es el eslabón más débil del ecosistema: alrededor del 45% de los skills que hemos puesto a prueba tenía problemas de activación, desde "solo se dispara si citas el nombre del skill" hasta "no se dispara nunca". Por eso la fiabilidad de activación es una puntuación separada de 5 puntos en cada ficha de SkillProof, en lugar de algo que diluimos en una nota general.

La verificación lleva dos minutos:

1. Reinicia Claude Code (o empieza una conversación nueva en claude.ai).
2. Pregunta a Claude directamente: "¿Qué skills tienes disponibles?" Un skill bien instalado aparece en la lista. Si no aparece, tienes un problema de ruta, no de activación; vuelve a la estructura de carpetas.
3. Dale una tarea que obviamente debería activar el skill, formulada con naturalidad, sin nombrar el skill. Para DOCX: "Crea un documento de Word que resuma este proyecto". Observa si Claude anuncia que está usando el skill.
4. Después formula la misma tarea tal y como la escribirías de verdad un martes por la tarde. Este es el test que importa. Muchos skills pasan el paso 3 y fallan el paso 4.

Si el skill aparece en el paso 2 pero no se dispara en el paso 4, el arreglo suele ser editar la description de su frontmatter para incluir las palabras que tú usas de verdad. Puedes hacerlo; es tu copia. Nuestro validador de skills gratuito revisa un SKILL.md en busca de los errores de frontmatter que causan activaciones débiles, y te señalará una descripción demasiado corta o demasiado genérica antes de que quemes una sesión descubriéndolo por las malas.

Para los skills con una puntuación de activación por debajo de 5/5 en nuestro catálogo, las notas de test de la ficha dicen exactamente qué formulación los hizo dispararse. Eso suele ser más rápido que arreglar el frontmatter tú mismo.

Actualizar y eliminar skills

No hay comando de actualización para los skills instalados por carpeta. Actualizar significa reemplazar la carpeta:

cd skills && git pull
cp -r document-skills/docx ~/.claude/skills/

Si borraste el clon después de instalar, clona de nuevo y copia de nuevo. Este es un punto genuinamente débil del enfoque de carpetas; nada te avisa de que existe una actualización. Los skills instalados por plugin salen mejor parados, porque el sistema de plugins gestiona las versiones. Es una razón más para preferir la vía del plugin cuando se ofrece.

Una nota práctica si has personalizado el frontmatter de un skill para arreglar su activación: una copia a ciegas sobrescribirá tus cambios. Haz un diff antes de reemplazar. Nosotros guardamos los skills personalizados en un pequeño repo git propio y fusionamos los cambios del upstream de forma deliberada, lo cual suena a exceso hasta la primera vez que una actualización revierte un arreglo en silencio.

Eliminar un skill es la única parte de todo este sistema sin trampas:

rm -rf ~/.claude/skills/docx

Reinicia Claude y desaparece. Los skills no tocan el estado del sistema, no registran nada, no dejan configuración atrás. En claude.ai, elimina el skill desde los ajustes de capacidades. Nada más.

Solución de problemas

Cuatro modos de fallo cubren casi todos los reportes de "lo instalé y no pasó nada" que hemos recibido.

El skill nunca se dispara. Primero comprueba que aparece cuando le preguntas a Claude qué skills tiene. Si está listado pero dormido, la descripción del frontmatter es demasiado vaga para que Claude la case con tus peticiones, un bug de autoría que heredas al instalar. Pasa el SKILL.md por el validador de skills y luego reescribe la descripción con frases de activación concretas: nombra los formatos de archivo, los verbos, las situaciones. "Helps with documents" no se dispara con nada. "Use when the user wants to create, edit or convert .docx Word files" se dispara de forma fiable. Si de todas formas vas a editar frontmatter, nuestra guía para escribir tu propio skill de Claude explica qué hace que una descripción se dispare, y las mismas reglas aplican para reparar la de otra persona.

Colisiones de nombres. Dos skills con el mismo nombre de carpeta, uno global y otro de proyecto, y el de proyecto gana en silencio. O dos skills que cubren el mismo dominio (dos skills de revisión de código, por ejemplo) y la activación se convierte en una moneda al aire. Revisa tanto ~/.claude/skills/ como el .claude/skills/ del proyecto actual cuando el comportamiento parezca inconsistente. Para solapamientos del mismo dominio, quédate con uno; no hay un sistema de prioridades que configurar, y en nuestras pruebas los skills solapados se degradan entre sí incluso cuando ambos son buenos por separado.

Necesita un reinicio. Los skills se escanean al arrancar, no se vigilan en caliente. Cada instalación, actualización o eliminación requiere reiniciar Claude Code para que surta efecto. Obvio una vez lo sabes, invisible hasta que lo sabes. Estimamos que un tercio de los reportes de "instalación rota" que recibimos son solo esto.

Permisos. Si Claude lista el skill pero da error al usarlo, comprueba que los archivos son legibles (chmod -R u+r ~/.claude/skills/<name> en macOS/Linux) y que cualquier script incluido es ejecutable. Las carpetas copiadas de descargas zip o sincronizadas con herramientas tipo Dropbox a veces llegan con los permisos hechos un lío. En Windows, los archivos descargados de internet pueden traer una marca de bloqueo; clic derecho, Propiedades, Desbloquear.

Y un quinto, medio modo de fallo: skills con requisitos previos reales. Brand Guidelines se instala limpio pero no hace nada útil hasta que editas su configuración con tu paleta y tus fuentes, y por eso sacó un 3/5 en facilidad de instalación pese a ser un buen skill. Cuando una ficha de nuestra web dice "funciona con configuración", se refiere a esto. Lee las notas de test antes de asumir que el skill está roto.

Instalar 10 skills de golpe

El método de copiar y pegar escala de forma lineal y dolorosa: diez skills son diez clones o diez copias, diez comprobaciones de activación y una probabilidad real de que dos se solapen. No hay instalador masivo oficial.

Nuestra respuesta son los bundles de SkillProof: sets curados de skills testeados que se instalan con un solo comando. Cada bundle trae una configuración verificada donde cada skill pasó nuestras pruebas individualmente y el conjunto se revisó en grupo en busca de conflictos de activación, porque "diez skills buenos" y "diez skills que funcionan juntos" son afirmaciones distintas. Si prefieres montar tu propio stack, la vía gratuita es un repo git personal con las carpetas de tus skills elegidos y un cp -r my-skills/* ~/.claude/skills/ de una línea. Pierdes las pruebas de conflictos, pero ganas una configuración reproducible que puedes poner en una segunda máquina en treinta segundos.

En cualquier caso, resiste la tentación de instalar veinte skills por si acaso. Todas las descripciones de skills se leen cuando Claude decide qué activar, y una carpeta de skills abarrotada y llena de descripciones vagas empeora la activación de todo. Instala lo que vayas a usar este mes. Añade más cuando una tarea lo pida.

FAQ

¿Dónde se instalan los skills de Claude? En Claude Code: ~/.claude/skills/ para skills globales, <project>/.claude/skills/ para los de ámbito de proyecto. En Windows, %USERPROFILE%\.claude\skills\. En claude.ai y Claude Desktop, los skills se suben como zips en Ajustes → Capacidades y se guardan con tu cuenta, no en disco.

¿Tengo que reiniciar Claude Code después de instalar un skill? Sí, siempre. Los skills se escanean una vez al arrancar. Instalaciones, actualizaciones y eliminaciones surten efecto en el siguiente arranque, y esta es la razón más común de que una instalación recién hecha "no funcione".

¿Puedo instalar skills sin git? Sí. Descarga el repo como zip desde GitHub, extráelo y copia la carpeta del skill en ~/.claude/skills/. Git solo facilita las actualizaciones; no es obligatorio para nada.

¿Por qué mi skill instalado no se activa nunca? Suponiendo que la ruta está bien, la description del frontmatter de su SKILL.md es demasiado vaga para que Claude la case con tus peticiones. Aproximadamente el 45% de los skills que testeamos tiene este problema. Edita la descripción para incluir frases de activación concretas, o consulta nuestro validador de skills y las notas de test del skill en SkillProof para ver soluciones conocidas.

¿Es seguro instalar skills de Claude? Un skill son instrucciones más scripts opcionales que Claude puede ejecutar, así que trátalo como cualquier código que ejecutas: lee el SKILL.md antes de instalar, desconfía de los repos sin mantenimiento y prefiere skills que alguien haya testeado. Cada skill de nuestro catálogo fue instalado y ejecutado por nosotros antes de listarlo, y el veredicto de la ficha refleja lo que pasó de verdad.