Herramientasclaude code
Instalar skills en Claude Code: pasos y seguridad
Aprende a instalar skills en Claude Code, comprobar que se cargan y revisar archivos de terceros con un ejemplo sencillo y rutas oficiales actualizadas.
- Autor: humAIns
- 10 min de lectura
índice · 8 apartados
Para instalar una skill en Claude Code, crea una carpeta que contenga SKILL.md y guárdala en la ubicación adecuada: en tu directorio personal para reutilizarla en distintos proyectos de esta máquina, o en el repositorio para compartirla con ese equipo. Después, comprueba que aparece en Claude Code y prueba sus instrucciones con documentación ficticia. Una skill es un conjunto de instrucciones que el asistente puede cargar cuando viene al caso o ejecutar cuando la invocas; no es una garantía de que sus recomendaciones sean correctas.
Si quieres entender primero el concepto, consulta qué es un skill en IA. Esta guía se centra en el procedimiento concreto para Claude Code, las rutas y las comprobaciones de seguridad.
Qué hace una skill y qué necesitas antes de instalarla
Una skill reúne instrucciones reutilizables en un archivo SKILL.md; puede incluir además documentos de apoyo. Claude Code puede cargarla cuando la tarea coincide con su descripción, y también permite invocarla con un comando como /revisar-docs. Así no tienes que volver a pegar la misma lista de comprobación en cada conversación.
Antes de empezar, necesitas Claude Code instalado y una carpeta donde puedas crear archivos. No es obligatorio saber programar para escribir instrucciones en Markdown. Sí conviene reconocer una ruta de directorio, abrir un archivo de texto y entender qué hace cualquier comando antes de ejecutarlo. La documentación oficial de skills de Claude Code explica el formato y los lugares de instalación; sus rutas pueden evolucionar, así que vuelve a consultarla si una versión futura se comporta de otra manera.
Elige la ruta según quién debe usar la skill
Anthropic documenta ubicaciones distintas según alcance. La skill personal reside en ~/.claude/skills/<nombre>/SKILL.md y puede utilizarse en los proyectos de esa máquina. Una skill de proyecto reside en .claude/skills/<nombre>/SKILL.md dentro del repositorio: se comparte con el equipo cuando se versiona, pero no se convierte por ello en una configuración personal global.
| Alcance | Ubicación | Quién la usa |
|---|---|---|
| Personal | ~/.claude/skills/revisar-docs/SKILL.md | Tus proyectos en esta máquina |
| Proyecto | .claude/skills/revisar-docs/SKILL.md | Sesiones que trabajan en ese repositorio |
| Subdirectorio | <subdir>/.claude/skills/revisar-docs/SKILL.md | Trabajo en el subdirectorio, según las reglas de descubrimiento |
Para crear la carpeta personal desde el terminal:
mkdir -p ~/.claude/skills/revisar-docs
Para instalarla solo en el repositorio, abre la raíz de tu proyecto y crea la carpeta allí:
mkdir -p .claude/skills/revisar-docs
El segundo comando crea archivos en el directorio actual. Comprueba con pwd que estás en el repositorio correcto antes de ejecutarlo. No uses la ruta personal si lo que buscas es que la skill forme parte del proyecto y el equipo pueda revisarla en Git. Tampoco guardes instrucciones específicas de un cliente en una carpeta personal que usarás para otros contextos.
En monorepos, Claude Code también busca skills de proyecto en directorios padre desde el lugar de inicio hasta la raíz del repositorio. Una skill bajo un subdirectorio puede no aparecer inmediatamente al arrancar desde arriba; la documentación describe cuándo se descubre al trabajar en esa zona y cuándo puedes añadir el directorio. Para evitar confusiones, empieza la sesión desde el proyecto o subdirectorio donde quieres utilizarla y revisa el comportamiento actual en la guía oficial.
Crea un SKILL.md mínimo y seguro
Cada skill requiere un archivo SKILL.md. El formato incluye frontmatter YAML entre líneas --- y un cuerpo de instrucciones en Markdown. La descripción indica cuándo resulta útil; el nombre de la carpeta puede usarse para invocarla, y el campo name puede personalizar el nombre. Mantén la prueba inicial limitada a leer y resumir texto ficticio: no necesita scripts, permisos de escritura ni acceso a servicios.
Crea ~/.claude/skills/revisar-docs/SKILL.md (o la misma ruta bajo .claude/skills/ si elegiste el alcance de proyecto) con este ejemplo:
---
description: Revisa documentación ficticia y señala los puntos que requieren comprobación. Usa esta skill cuando se pida revisar una nota o procedimiento de ejemplo.
---
## Instrucciones
1. Resume el objetivo del texto en una frase.
2. Separa los pasos explícitos de las suposiciones.
3. Señala cualquier afirmación que no pueda verificarse en el propio texto.
4. No inventes datos ni afirmes que has consultado fuentes externas.
5. No solicites ni incluyas contraseñas, claves, datos personales o información confidencial.
Guarda el archivo como texto plano con el nombre exacto SKILL.md, respetando mayúsculas. Puedes usar cualquier editor de texto. En este ejemplo no es necesario añadir comandos al frontmatter ni adjuntar archivos: una skill sencilla puede consistir únicamente en descripción e instrucciones. Si una guía descargada propone campos adicionales, comprueba primero para qué sirven y si están admitidos por la documentación actual.
Instala skills de terceros con una revisión previa
Descargar una carpeta no equivale a verificarla. Antes de copiar una skill de un repositorio externo, identifica quién mantiene el proyecto, cuándo cambió por última vez y qué licencia y alcance declara. Lee el SKILL.md entero, no solo el título. Revisa también todos los archivos enlazados desde él: instrucciones secundarias, ejemplos y scripts pueden introducir acciones que no se ven en la descripción.
Busca especialmente instrucciones para ejecutar comandos, descargar programas, modificar archivos, enviar solicitudes de red, leer variables de entorno o acceder a rutas fuera del proyecto. Una skill es texto que orienta al modelo, pero también puede acompañarse de código que tú o una herramienta podríais ejecutar. No ejecutes scripts por rutina; inspecciónalos línea por línea y pide revisión técnica si no entiendes su efecto. Si la instalación solo requiere el archivo de instrucciones, copia solo ese archivo y los recursos que hayas comprobado que necesitas.
Para una primera evaluación, puedes pegar en Claude un fragmento ficticio y pedir una revisión con la skill. Por ejemplo:
Procedimiento de muestra: guardar el informe en una carpeta de ejemplo y comprobar el título antes de compartirlo. Indica el objetivo, los pasos que aparecen y qué dato falta para confirmar que el procedimiento está completo. No añadas información externa.
Comprueba que la respuesta separa lo que el texto dice de lo que no consta. Si la skill pide un token, invita a desactivar protecciones o afirma haber ejecutado algo que no le pediste, detén la prueba y elimina la copia hasta entender el motivo. No compartas claves, documentos internos, datos de clientes ni información personal durante esta comprobación.
Comprueba la activación y diagnostica fallos
Abre Claude Code desde el directorio del proyecto donde guardaste una skill de proyecto, o desde cualquier proyecto si instalaste la skill personal. En el prompt, escribe / y busca revisar-docs; también puedes invocarla directamente con /revisar-docs. El flujo de activación por descripción se comprueba con una petición que coincida claramente con ella. Usa únicamente el párrafo inventado anterior y evalúa si la respuesta siguió los pasos.
Si no aparece, revisa en este orden:
- ¿El archivo se llama exactamente
SKILL.md, incluida la combinación de mayúsculas? - ¿Está dentro de una carpeta de skill, no suelto directamente en
.claude/skills/? - ¿La ruta es la adecuada para el alcance elegido y has iniciado Claude Code en el proyecto correcto?
- ¿El frontmatter tiene los delimitadores
---y una descripción legible, sin errores de formato? - ¿La carpeta o el proyecto tienen un nombre válido y no coinciden con un nombre reservado que Claude Code omite?
- ¿Has comprobado la documentación de tu versión por si hay una condición de configuración, confianza del espacio de trabajo o descubrimiento en subdirectorios?
Por ejemplo, esta estructura es correcta para una skill de proyecto:
mi-proyecto/
└── .claude/
└── skills/
└── revisar-docs/
└── SKILL.md
Si la invocación manual funciona pero no se activa automáticamente, revisa la descripción: debe explicar con claridad qué tareas corresponden a la skill. Una descripción vaga como «ayuda con documentos» ofrece menos señales que «revisa procedimientos y separa afirmaciones verificables de supuestos». No conviertas esa optimización en una instrucción para activarse en todo momento si solo debe aplicarse a una tarea específica.
Seguridad, límites y mantenimiento
Las instrucciones de una skill no sustituyen los controles de permisos de Claude Code ni la revisión de una persona. Escribe reglas que delimiten la tarea, los datos que no debe solicitar y qué debe dejar como «no consta». Contrasta resultados con los documentos originales; Claude puede omitir, interpretar mal o inventar detalles aunque la skill le pida precisión.
Evita poner secretos en SKILL.md, en ejemplos, en nombres de archivos o en el historial de comandos. No uses documentación confidencial para una prueba y no concedas permisos amplios para que una skill parezca funcionar. Si una habilidad de terceros propone acciones con efectos externos —por ejemplo, borrar, publicar o enviar información—, no las pruebes con datos reales. Limita el ensayo a una copia de prueba sin acceso a cuentas ni sistemas productivos.
Para trabajo en equipo, guarda la skill de proyecto en el repositorio y revisa el diff antes de confirmarla; así el equipo puede ver qué instrucciones se comparten. Una skill personal es más apropiada para preferencias propias que no deben aplicarse al resto del repositorio. Si ya no la necesitas, elimina su carpeta del lugar donde la instalaste. Para cambios de formato o dudas sobre carga, consulta la referencia de Anthropic en vez de asumir que una opción de una versión antigua sigue vigente.
Si quieres comparar cómo se organizan estas instrucciones en otras herramientas, lee nuestra guía de skills en GitHub Copilot. Para integrar Claude en tus tareas cotidianas, consulta cómo usar Claude en el trabajo. Y para aprender a evaluar usos profesionales de IA, explora el curso de IA para marketing, sin asumir que cubre específicamente Claude Code o skills. También puedes hacer el test ¿Cuánto te queda? para identificar áreas en las que quieres seguir practicando.
Preguntas frecuentes
¿Dónde se guarda SKILL.md?
En una carpeta con el nombre de la skill: ~/.claude/skills/nombre/SKILL.md para uso personal o .claude/skills/nombre/SKILL.md dentro del repositorio para uso de proyecto. La ubicación determina el alcance.
¿Cómo sé si Claude Code detecta la skill?
Abre el menú / y busca su nombre o invócala directamente, por ejemplo /revisar-docs. Prueba con una tarea inventada y comprueba si sigue el procedimiento; si no aparece, verifica nombre, estructura, frontmatter y directorio de inicio.
¿Una skill de proyecto se aplica a todos mis proyectos?
No. La skill guardada en .claude/skills/ pertenece a ese repositorio. Para reutilizarla en varios proyectos de esta máquina, utiliza el directorio personal ~/.claude/skills/.
¿Debo ejecutar scripts de una skill descargada?
No de forma automática. Revisa su código, procedencia, permisos y efectos. Si no puedes explicar qué hace, no lo ejecutes; tampoco le proporciones credenciales ni datos confidenciales.
Fuentes oficiales
Sigue leyendo en humAIns