01 Por qué importa dónde instalas una skill
Una skill es una carpeta con un archivo SKILL.md que enseña a Claude a hacer algo concreto. En cada sesión, Claude Code carga una lista con el nombre y la descripción de todas las skills disponibles; el contenido completo solo entra cuando la skill se usa. Esa lista tiene un presupuesto de espacio de aproximadamente el 1 % de la ventana de contexto del modelo.
Si acumulas decenas de skills globales, pasan dos cosas. Primero, la lista ocupa contexto en cada turno, aunque no uses ninguna. Segundo, cuando la lista no cabe, Claude Code recorta descripciones empezando por las skills que menos usas, y sin descripción Claude ya no sabe cuándo activarlas. El resultado se parece a que Claude «no ve» tus skills o activa la que no toca.
02 Dónde puede vivir una skill
| Ubicación | Ruta | Quién la ve |
|---|---|---|
| Personal (global) | ~/.claude/skills/nombre/SKILL.md | Todos tus proyectos en este ordenador |
| Proyecto | .claude/skills/nombre/SKILL.md | Las sesiones en ese repositorio; si la subes a git, todo el equipo |
| Subcarpeta | subcarpeta/.claude/skills/nombre/SKILL.md | Sesiones que trabajan en esa parte del repositorio (útil en monorepos) |
| Plugin | Dentro del plugin, en skills/ | Donde el plugin esté activado, como /plugin:skill |
| Empresa | Directorio de configuración gestionada | Todos los usuarios de la organización en esos equipos |
03 La regla para decidir
Antes de instalar, pregúntate: ¿la usaré en proyectos de temas muy distintos? Si la respuesta es sí, va en tu carpeta personal. Si solo tiene sentido con un tipo de proyecto, una herramienta o un cliente, va en ese proyecto.
Buenas candidatas a global
Estilo de escritura propio, revisión de textos, convenciones personales de commits, utilidades de configuración de tu Claude Code.
Mejor por proyecto
Trabajo con PDF u hojas de cálculo, pruebas de navegador, una API concreta (Shopify, Stripe, la API de Claude), despliegues de un servidor.
Siempre por proyecto
Flujos internos de un cliente: su guía de marca, su proceso de publicación, su base de datos. No quieres que se activen con otro cliente.
Colecciones y plugins
Un plugin suele traer muchas skills. Actívalo solo donde lo necesites y, de un catálogo grande, saca únicamente las skills que vayas a usar.
04 Controlar cuándo se activa una skill
Además de la ubicación, el frontmatter de SKILL.md te da control fino. La description es lo que Claude lee para decidir: pon el caso de uso principal al principio y sé concreto. Con paths limitas la activación automática a ciertos archivos, y con disable-model-invocation: true la skill solo se ejecuta cuando tú escribes su comando.
---
name: facturas-cliente
description: Genera y revisa facturas en PDF con el formato de este cliente. Úsala al crear, corregir o validar facturas.
paths: facturas/**
---
Instrucciones de la skill…ls ~/.claude/skills/ # skills personales
ls .claude/skills/ # skills de este proyecto
# dentro de Claude Code
/skills # lista y permite activar o desactivar
/context # cuánto ocupa la lista de skills
/skill-doctor # coste y uso de cada skill05 Instalar en el sitio correcto
Quiero instalar esta skill solo en el proyecto actual: [URL del repositorio o ruta]. Antes de copiar nada, lee su SKILL.md y dime qué hace, qué archivos incluye y si ejecuta scripts o comandos. Después créala en .claude/skills/[nombre]/ de este repositorio, nunca en ~/.claude/skills/. Revisa que la description empiece por el caso de uso principal y, si la skill solo aplica a ciertas carpetas, propón un campo paths. Al final confirma la ruta y comprueba con /skills que aparece.Instala esta skill en mi carpeta personal ~/.claude/skills/[nombre]/: [URL o ruta]. Antes, revisa su contenido y dime si hay alguna skill personal con un nombre parecido o una función que se solape. Mantén la description breve y concreta. No toques ninguna skill de proyecto.06 Auditar y limpiar lo que ya tienes
Revisa todas las skills de ~/.claude/skills/. Para cada una dame: nombre, qué hace en una frase, longitud de su description y una recomendación (mantener global, mover a proyecto, desactivar o eliminar) con el motivo. Señala las que se solapan entre sí y las de terceros que ejecutan scripts. No muevas ni borres nada: solo quiero el informe en una tabla.Mueve la skill [nombre] de ~/.claude/skills/ a .claude/skills/ de este proyecto. Copia primero la carpeta completa, comprueba con /skills que aparece aquí y, solo cuando yo lo confirme, elimina la copia global. Dime en qué otros proyectos debería instalarla si la necesito.- ✓Repite la auditoría cada pocos meses o cuando notes que Claude ignora skills que antes usaba.
- ✓Si no quieres editar una skill compartida, desactívala o déjala solo con nombre desde /skills (se guarda en tu configuración local).
- ✓Las skills de plugins se gestionan desde /plugin, no desde /skills.
- ✓Recorta descripciones largas: cada entrada tiene un tope de 1.536 caracteres en la lista.
Preguntas frecuentes
No hay un número fijo. La señal de alarma es que /doctor o /context muestren una lista de skills grande o que Claude deje de activar skills que antes reconocía. Pocas y bien descritas funcionan mejor que muchas genéricas.
Sí, si subes la carpeta .claude/skills/ al repositorio. Quien clone el proyecto la tendrá disponible, también en las sesiones de Claude Code en la nube.
No. Claude Code detecta cambios en las carpetas de skills durante la sesión. Las partes de un plugin, como hooks o servidores MCP, sí necesitan /reload-plugins.
No automáticamente. En claude.ai y Cowork se usan las skills activadas en tu cuenta, que se gestionan desde Personalizar en la app. Tendrías que subirlas también allí.
Sobre el autor
Equipo editorial de appyweb
Marketing, SEO y desarrollo con IA
Especialistas de appyweb en SEO, publicidad, desarrollo web y automatización con IA.