La respuesta corta
- 1Pon la carpeta de la Skill en
~/.claude/skills/para usarla en todos los proyectos, o en.claude/skills/para limitarla a un repositorio. - 2¿Instalas con la CLI de Skillry? Añade
--agent claude-code. Sin esa opción, la Skill acaba en~/.agents/skills/, que Claude Code no lee. - 3Escribe
/skillspara confirmar que está, y luego/skill-nameseguido de tu petición para ejecutarla. - 4¿Quieres Skills listas para usar? Explora las Skills para Claude Code que se instalan con un solo comando.
Cómo añadir Skills a Claude Code
Puedes pegar un prompt de instalación en Claude Code, ejecutar tú mismo la CLI de Skillry o copiar la carpeta a mano. Todas las vías terminan igual: con la carpeta de la Skill dentro de ~/.claude/skills/.
La opción que todo el mundo olvida
La CLI de Skillry instala por defecto en ~/.agents/skills/, porque Codex y Cursor leen esa carpeta. Claude Code lee la suya, ~/.claude/skills/. Si omites --agent claude-code, la instalación dice que todo fue bien, pero Claude Code nunca ve la Skill.
- 1
Abre la Skill en Skillry, selecciona Copiar prompt de instalación y luego Copiar en el cuadro de diálogo.
- 2
Pégalo en Claude Code y envíalo. El agente lee las instrucciones de instalación de Skillry y ejecuta él mismo el comando correcto.
Prompt de instalación Read https://skillry.dev/skills/<slug>/install.md and follow the instructions to install the skill. - 3
Cuando el navegador te pida aprobar un código de dispositivo, apruébalo.
Deberías ver: Claude Code indica la versión que instaló y la carpeta que usó, dentro de
~/.claude/skills/.
- 1
Inicia sesión una vez. Se abre una ventana del navegador con un código de dispositivo que debes aprobar.
Terminal npx --yes skillry-cli@latest login - 2
Instala, con
--agent claude-codeal final.Terminal npx --yes skillry-cli@latest install <slug> --agent claude-codeDeberías ver:
Installed <slug> <version> to ~/.claude/skills/<slug>
Selecciona Descargar ZIP en la página de la Skill o usa una carpeta de Skill que hayas conseguido en otro sitio. Lee SKILL.md y todo lo que haya en scripts/ antes de instalarla, porque el agente sigue esas instrucciones y puede ejecutar esos scripts. Después mueve la carpeta entera:
mkdir -p ~/.claude/skills
mv ~/Downloads/my-skill ~/.claude/skills/Los ZIP suelen descomprimirse con un nivel extra, como my-skill/my-skill/SKILL.md. SKILL.md tiene que estar directamente dentro de la carpeta de la Skill; si no, el agente no la encontrará.
Comprueba que Claude Code la ve
Escribe /skills. La lista muestra tus Skills y algunas que vienen con Claude Code, como /code-review. Pulsa t para ordenarlas según el contexto que ocupa cada una.
No hace falta reiniciar. Claude Code detecta las Skills nuevas y editadas en la sesión actual. La única excepción: si ~/.claude/skills/ no existía cuando empezó la sesión, ejecuta /reload-skills una vez.
Ejecuta una Skill como comando de barra en Claude Code
Cada Skill que instalas aparece como un comando de barra con su nombre. Escribe el comando y, en la misma línea, di lo que quieres:
/launch-page Parcelo, un panel de seguimiento de paquetes para pequeñas tiendas onlineTodo lo que va después del nombre le llega a la Skill como $ARGUMENTS. Cuando ya hayas visto que funciona, normalmente puedes saltarte el comando y describir la tarea con tus palabras. Claude carga una Skill por su cuenta cuando tu petición encaja con su descripción. En Cómo usar las Skills hay más sobre cómo conseguir buenos resultados.
Dónde busca Claude Code las Skills y qué copia gana
Claude Code reúne Skills de cinco sitios. La mayoría de la gente solo usa las carpetas personal y de proyecto; las demás entran en juego en un equipo o cuando instalas plugins.
| Origen | Ubicación | Comando |
|---|---|---|
| Enterprise | Configuración gestionada | /skill-name |
| Personal | ~/.claude/skills/<name>/ | /skill-name |
| Proyecto | .claude/skills/<name>/ | /skill-name |
| Plugin | <plugin>/skills/<name>/ | /plugin-name:skill-name |
| Tu cuenta de claude.ai | Sincronizada en ~/.claude/skills/synced/ | /name o /anthropic-skills:name |
Cuando el mismo nombre existe en dos sitios, Enterprise gana a la personal y la personal gana a la del proyecto. Las Skills de la carpeta .claude/skills/ de una subcarpeta se cargan la primera vez que Claude trabaja con archivos de esa subcarpeta, así que las Skills de un paquete dentro de un repositorio grande no estorban hasta que las necesitas.
La configuración de SKILL.md que controla cuándo se ejecuta
Estos campos van en el frontmatter, al principio de SKILL.md. Solo los necesitas cuando una Skill se ejecuta demasiado, demasiado poco o se detiene a pedir permiso en cada paso.
| Campo en SKILL.md | Qué hace |
|---|---|
description | Lo que lee Claude para decidir si usa la Skill. Junto con when_to_use, se recorta a 1.536 caracteres en la lista de Skills. |
allowed-tools | Herramientas que Claude puede usar sin preguntar durante el turno en que se invoca la Skill. |
paths | Patrones de archivo. Claude carga la Skill automáticamente solo cuando trabaja con archivos que coinciden. |
¿Tu Skill de Claude Code no funciona? Revisa esto primero
Ve de arriba abajo. La primera fila, una Skill en la carpeta equivocada, es la causa más común.
No aparece en /skills
Carpeta equivocada o un nivel extra del ZIP. Muévela para que la ruta sea ~/.claude/skills/<name>/SKILL.md, o reinstálala con --agent claude-code.
La carpeta es totalmente nueva
Ejecuta /reload-skills.
Falta en una sesión en la nube
Haz commit de la Skill en .claude/skills/ del repositorio o actívala en claude.ai.
Falta en Cowork
Actívala en tu cuenta de claude.ai.
Aparece en la lista, pero nunca se elige
Llámala con /name para confirmar que funciona y luego haz su descripción más concreta. Consulta Activación.
Todo lo demás está en Solución de problemas.
Preguntas frecuentes
¿Funcionan las Skills en Claude Code?
Sí. Claude Code sigue el estándar abierto Agent Skills y carga Skills de tu carpeta personal, del proyecto actual, de plugins, de tu organización y de tu cuenta de claude.ai.
¿Dónde se guardan las Skills de Claude Code?
Tus propias Skills van en ~/.claude/skills/<name>/SKILL.md. Las Skills de un proyecto van en .claude/skills/<name>/SKILL.md dentro de ese repositorio.
¿Qué pasó con los comandos de barra personalizados?
Siguen funcionando. Un archivo en .claude/commands/deploy.md y una Skill llamada deploy te dan ambos /deploy. Si tienes los dos, gana la Skill.
¿Por qué la CLI de Skillry necesita --agent claude-code?
Su carpeta predeterminada es ~/.agents/skills/, que comparten Codex y Cursor. Claude Code lee ~/.claude/skills/, y esa opción dirige la instalación allí.
Fuentes
¿Te ha sido útil esta guía?