Los 4 chequeos antes de instalar una skill
Recurso 23 de 26, guía gratis
ALVEX / RecursosInstalar una skill toma diez segundos y abrirla un minuto: cuatro preguntas que se contestan sin saber programar.
Instalar una skill toma diez segundos. Abrirla, un minuto.
Una skill parece solo texto, pero la documentación de Anthropic dice que puede traer código, y que Claude puede ejecutarlo. Esta página es el minuto: cuatro preguntas que se contestan abriendo la carpeta, sin saber programar.
Antes de seguir, tres cosas honestas:
- Todo sale de la documentación oficial de Anthropic, leída el 12 de octubre de 2026. Las fuentes están al final.
- Esta lista no te dice que una skill es segura. Te dice qué mirar. La decisión es tuya.
- No recomiendo ni ataco ninguna skill en particular. Los ejemplos son para mostrar dónde mirar.
Por qué importa
Esto es lo que dice Anthropic en la sección de seguridad de su documentación de skills:
"Use Skills only from trusted sources: those you created yourself or obtained from Anthropic. Skills give Claude new capabilities through instructions and code, which also means a malicious Skill can direct Claude to invoke tools or execute code in ways that don't match the Skill's stated purpose."
Y si hay que usar una de una fuente desconocida: "exercise extreme caution and thoroughly audit it before use". Además, en Claude Code las skills tienen "the same network access as any other program on the user's computer".
En español: una skill de otra persona puede pedirle a Claude que haga cosas que no cuadran con lo que dice que hace. Por eso se abre antes de instalar.
Cómo se ve una skill por dentro
Una skill es una carpeta con un archivo obligatorio, SKILL.md, y opcionalmente otros archivos:
mi-skill/ ├── SKILL.md (obligatorio: instrucciones y cabecera) ├── otros .md (guías extra, se leen cuando hacen falta) └── scripts/ (código que se ejecuta, no solo se lee)
Arriba de SKILL.md hay una cabecera entre dos líneas de --- (se llama frontmatter) y después el texto con las instrucciones. Los scripts de la carpeta scripts/ se ejecutan. No se cargan como texto.
Dónde viven las skills en Claude Code:
~/.claude/skills/nombre/SKILL.md: personales, para todos tus proyectos en ese computador.claude/skills/nombre/SKILL.mddentro de un proyecto: solo ese proyecto, y se comparte con el equipo si está en el repositorio- dentro de un plugin: donde el plugin esté activado
Una skill que llega dentro de un repositorio o de un plugin también cuenta. Revisa lo que no instalaste tú.
Los 4 chequeos
Chequeo 1. Qué trae la carpeta
La pregunta: ¿es solo un SKILL.md o trae más archivos, sobre todo una carpeta scripts/?
| Cómo lo compruebo | Qué hago con la respuesta |
|---|---|
| Abre la carpeta en el explorador de archivos. Mira todo lo que hay, también las carpetas internas | Solo un SKILL.md es lo más fácil de revisar: todo lo que puede hacer está escrito en ese texto. Si hay scripts/, hay código que se ejecuta en tu computador. Ábrelo también. Anthropic pide revisar todos los archivos: SKILL.md, scripts, imágenes y otros recursos |
Chequeo 2. Qué permisos pide
La pregunta: ¿qué dice la cabecera del SKILL.md?
| Campo de la cabecera | Qué hace, según la documentación de Claude Code | Qué miro |
|---|---|---|
allowed-tools | Las herramientas que Claude puede usar sin preguntarte durante el turno en que se invoca la skill | Si dice Bash, puede correr comandos sin pedirte permiso. Si dice algo más acotado, por ejemplo un solo script, es más estrecho |
hooks | Registra hooks que se quedan activos el resto de la sesión | Que no haya, o que sepas qué hacen |
context: fork | Corre la skill en un subproceso aparte | Es una forma de ejecución. Anótalo y sigue leyendo |
disable-model-invocation | Si es true, Claude no la carga solo, solo la invocas tú | Es una restricción a tu favor |
paths | Limita cuándo Claude la carga solo | Informativo |
Un detalle de la documentación que conviene saber. Anthropic advierte: "A skill can grant itself broad tool access, so review the allowed-tools of skills checked into a repository before you run Claude Code there." Y aclara que la confianza en el espacio de trabajo no frena este campo: Claude Code aplica el allowed-tools de una skill de proyecto incluso en una carpeta que nunca has aceptado como de confianza.
Chequeo 3. Qué le manda ejecutar
La pregunta: ¿qué comandos aparecen dentro del texto de la skill?
| Qué busco en el texto | Qué significa |
|---|---|
Líneas con npx, pip, curl, wget, bash | Le pide a Claude instalar o descargar cosas. Mira de dónde y si lleva una opción que salta la confirmación (por ejemplo -y) |
Un comando entre !`...` o un bloque que abre con tres comillas invertidas y un signo de exclamación | Se ejecuta antes de que Claude lea la skill. La documentación lo llama shell injection y corre el comando directamente. Si no lo esperabas, es una bandera |
Referencias a una carpeta scripts/ | Pide correr esos archivos. Vuelve al chequeo 1 y ábrelos |
| Direcciones web de donde la skill dice que traiga instrucciones o datos | Anthropic dice que las skills que traen datos de URLs externas "pose particular risk", porque lo traído puede tener instrucciones maliciosas, y que una skill de confianza puede dejar de serlo si cambia lo que descarga |
Dos interruptores de Claude Code para saber que existen:
disableSkillShellExecution: trueen tus ajustes frena los comandos de tipo!`...`de skills de usuario, de proyecto y de plugins. Cada comando se reemplaza por un aviso.- Los comandos de ese tipo se revisan primero contra tus reglas de permisos. Una regla de denegar aborta la skill.
Chequeo 4. De dónde viene
La pregunta: ¿la hiciste tú, es de Anthropic, o es de otra persona?
| Cómo lo compruebo | Qué hago con la respuesta |
|---|---|
| Mira quién la publicó y en qué sitio. Revisa si es la fuente original o una copia | Anthropic dice que se usen skills "tuyas o de Anthropic". Si es de otra persona, la regla es auditarla a fondo (chequeos 1 a 3) antes de usarla |
| Si viene de un directorio que muestra instalaciones o puntajes de auditoría, lee eso como una pista, no como una garantía | La documentación de Anthropic consultada no habla de ningún directorio de terceros ni dice que un puntaje reemplace la revisión |
Un ejemplo de lectura, sin juzgar
Para mostrar dónde mirar, estas son dos skills públicas de otras personas. No digo que sean buenas ni malas. Digo qué se ve al abrirlas.
| Chequeo | find-skills | watch |
|---|---|---|
| 1. Qué trae | Un solo archivo, SKILL.md | SKILL.md y una carpeta scripts/ con varios archivos de Python y uno de shell |
| 2. Permisos | La cabecera solo tiene name y description | allowed-tools: Bash, Read, AskUserQuestion |
| 3. Qué manda ejecutar | En el paso de instalar, una línea npx skills add <owner/repo@skill> -g -y, que instala otras skills a nivel de usuario y salta la confirmación | Hay scripts que abrir antes de saber qué ejecuta |
Lo que enseña la tabla es el método. Con un SKILL.md solo se contesta rápido. Con una carpeta scripts/ hay más que abrir.
La lista para llevar
Antes de instalar una skill, marca:
- Qué trae: abrí la carpeta. ¿Solo
SKILL.md, o hayscripts/? Abrí todo lo que hay. - Qué permisos pide: leí la cabecera. ¿
allowed-tools? ¿hooks? - Qué manda ejecutar: leí el texto buscando
npx,pip,curl, comandos con!`...`y direcciones web. - De dónde viene: sé quién la publicó, y si no es mía ni de Anthropic, la audité.
Si algo no cuadra con lo que la skill dice hacer, no la instales.
Qué cubre esta lista y qué no
- Cubre lo que se puede ver sin saber programar: qué archivos hay, qué pide la cabecera, qué comandos aparecen y quién la publicó.
- No cubre entender cada línea de un script. Eso puede requerir a alguien que lea código.
- No cubre que una skill cambie después de instalada. La documentación advierte que una skill de confianza puede dejar de serlo si sus dependencias externas cambian.
Fuentes (leídas el 12 de octubre de 2026)
- Anthropic, Skills, resumen, sección "Security considerations": platform.claude.com/docs/en/agents-and-tools/agent-skills/overview
- Claude Code, Skills (estructura, cabecera,
scripts/, shell injection,disableSkillShellExecution, advertencia deallowed-tools): code.claude.com/docs/en/skills