Cómo instalar Skills en Claude Code: comandos, alcance y verificación

Claude Code incluye Skills como /code-review, /debug y /batch. Un Agent Skill independiente es una carpeta cuyo punto de entrada es SKILL.md. Un plugin de Claude Code es un paquete que puede incluir Skills, agentes, hooks y servidores MCP.

Elige la ruta según el contenido real. Una Skill independiente no necesita convertirse en plugin, y un plugin no es solo otro nombre para un archivo SKILL.md.

Ejecuta el primer comando desde el repositorio donde quieres instalar la Skill. El comando especifica Claude Code y usa el alcance de proyecto predeterminado. El segundo añade alcance personal para una Skill que realmente quieras usar en varios proyectos de este equipo.

Son ejemplos concretos de la documentación del CLI, no una recomendación para instalar ese paquete en particular. Antes de ejecutar nada, comprueba el repositorio, la carpeta exacta de la Skill y sus permisos.

• Usa alcance de proyecto para un flujo específico del repositorio o que el equipo deba revisar junto con el código.
• Usa -g solo cuando quieras deliberadamente reutilizar el flujo entre proyectos. Se instala en tu directorio de usuario; no es una instalación administrativa para todo el equipo.
• Lee las preguntas del instalador. No añadas --yes solo para omitir una elección de origen, alcance o método que aún no hayas revisado.

Si la fuente no permite generar un comando fiable, abre el repositorio indicado y copia la carpeta completa de la Skill. Mantén SKILL.md junto con los scripts, ejemplos, plantillas y archivos auxiliares que este mencione; copiar solo el archivo de entrada puede romper referencias.

Claude Code usa rutas diferentes para Skills del repositorio y personales. En Windows, la ruta personal está dentro de tu perfil de usuario y no requiere una cuenta de administrador.

• Mantén una sola copia canónica salvo que necesites intencionadamente ambos alcances.
• Comprueba que la carpeta final contiene SKILL.md y cada archivo que las instrucciones referencian.
• Para una configuración de equipo reproducible, prefiere la ruta de proyecto y revisa los archivos versionados como cualquier otro cambio.

El listado del CLI comprueba qué instaló Skills CLI para Claude Code. Dentro de una sesión interactiva, ejecuta /skills para confirmar que Claude Code la detecta. Si el alcance importa, revisa también el directorio: el listado y la ruta responden preguntas distintas.

Puedes invocar una Skill con /nombre o describir una tarea relacionada para que Claude Code la seleccione cuando corresponda. Si creas la carpeta raíz .claude/skills después de iniciar la sesión, ejecuta /reload-skills una vez. Si ya existía al abrirla, Claude Code normalmente observa los cambios en SKILL.md.

• El nombre de la carpeta o el campo name de SKILL.md coincide con el comando que esperas usar.
• /skills muestra la Skill en la misma sesión local donde la instalaste.
• Pruébala primero con una tarea pequeña y reversible, sin secretos ni credenciales de producción; después revisa el resultado y los cambios.

Una descarga correcta, una Skill visible en el listado del instalador y una Skill disponible en la sesión actual son tres comprobaciones distintas. Identifica el síntoma antes de reinstalar: el problema puede ser el Agent de destino, el nombre del comando o el tipo de sesión.

Cowork y las sesiones en la nube no leen ~/.claude/skills/ de tu ordenador. Cargan las Skills habilitadas para tu cuenta de claude.ai; las sesiones en la nube también pueden usar Skills del proyecto versionadas en .claude/skills/. Una instalación personal con -g no sincroniza la Skill entre equipos ni con la nube.

Si el paquete incluye hooks, servidores MCP u otros componentes, puede ser un plugin y no una Skill independiente. Usa el flujo de plugins y revisa cada componente que vaya a habilitarse.

• Sesión local de terminal: verifica la ruta local y el listado /skills de Claude Code.
• Cowork o nube: habilita la Skill para la cuenta según la política del equipo o usa una Skill de proyecto versionada.
• Plugin: revisa Skills, agentes, hooks y servidores MCP antes de habilitarlo; no asumas que solo añade instrucciones de texto.

Un ranking, el número de instalaciones o una instalación exitosa no demuestran qué hará una Skill en tu repositorio. Lee las instrucciones y los archivos que mencionan, registra la revisión de la fuente y comprueba qué archivos, comandos, conexiones o credenciales necesitaría la primera tarea.

Empieza con una prueba pequeña, delimitada y reversible. Trata la salida como evidencia que debe revisarse, no como autorización para publicar, fusionar cambios o modificar producción.

• El repositorio de origen y la carpeta de la Skill son exactamente los que querías instalar.
• Los scripts y archivos referenciados están presentes y tienen relación comprensible con la tarea.
• La primera prueba tiene límites claros, un resultado revisable por una persona y una vía de reversión.