Mejores Prácticas Para Skills Con Claude — Global, Por Proyecto Y Cómo Decidir

Lo que hace la mayoría: Ves una skill que se ve cool, le dices a Claude que la instale, y termina global. Ves otra, otra más, otra. A la semana tienes 15 habilidades globales. Llegas a trabajar en un proyecto concreto y Claude ni las usa, las confunde, o activa la que no toca.

Y tú culpas a Claude: “Es que Claude está flojo”, “es que no entiende”. No. Lo que pasa es que cada skill global la carga en TODAS tus sesiones — aunque estés programando algo que no tiene nada que ver con esa skill. Ensucia su contexto. Lo vuelve más lento y menos preciso.

La buena noticia: No tienes que instalar menos skills. Tienes que instalarlas donde corresponde. Y hay una sola regla.

Antes de instalar cualquier skill, pregúntate una cosa: ¿La voy a usar en al menos 3 proyectos distintos que son de temas distintos? Si la respuesta es SÍ, va global. Si es NO — va solo en el proyecto donde la necesitas.

Por qué funciona: Cada proyecto prende solo las habilidades que tienen sentido ahí. Tu carpeta global queda limpia, pequeña, y Claude la lee sin confundirse. Cuando abres un proyecto específico, ves global + las skills de ese proyecto — exactamente lo que necesitas.

Mucha gente le dice “skill” a todo y por eso se confunde. Hay tres capas distintas — entenderlas te salva de instalar un paquete gigante global pensando que era una sola habilidad.

La regla aplica igual: sea skill suelta, colección o plugin — si no lo vas a usar en todos tus proyectos, no tiene por qué vivir global.

Estas son las candidatas clásicas a global: transversales, agnósticas al stack, útiles casi cada vez que abres Claude. Si una skill encaja con este perfil, métela en ~/.claude/skills/ sin culpa.

• humanizalo

  Arregla textos para que suenen humanos. Lo usas en correos, guiones, landing pages, posts — en todos lados. Global 100%.

• ui-ux-pro-max

  Inteligencia de UI/UX con paletas, tipografías y patrones. Si haces interfaces más de una vez al mes, no tiene sentido reinstalarla cada proyecto.

• frontend-design

  Código de interfaces con buen gusto, menos estética genérica de IA. Transversal a cualquier frontend que toques.

• simplify

  Revisa tu código cambiado para reutilizar lo que ya existe y evitar abstracciones prematuras. Aplica a cualquier repo.

• fewer-permission-prompts

  Detecta comandos repetidos y arma un allowlist para que Claude Code deje de preguntarte por cada cosa. Configuración personal, no de proyecto.

• keybindings-help

  Ajustes de teclado de Claude Code. Son tuyos, no del proyecto — global obvio.

Estas son las que, si están globales, te van a cargar contexto innecesario en cada sesión. Ponlas en .claude/skills/ dentro del proyecto donde sí aplican.

• pdf

  Leer, generar, combinar y hacer OCR de PDFs. Solo cargas esta skill en un proyecto que trabaje con PDFs. Si está global, se activa en cada proyecto random donde estés codeando.

• playwright-cli

  Automatizar browsers y testear páginas. Solo aplica cuando el proyecto tiene una UI que estás testeando. No hace nada en un repo de backend puro.

• claude-api

  Optimizar apps que consumen la Claude API (caching, thinking, tool use). Solo la quieres activa en proyectos que usan el SDK de Anthropic — si no, ensucia el contexto.

• skill de un stack específico

  Shopify, Vercel, Blender, TradingView — todo lo que es de una herramienta o API. Vive en el proyecto que usa esa herramienta, punto.

• skill de un flujo interno

  Deploy de tu CRM, migración de tu base de datos, estilo de escritura de tu marca. Es de ese negocio o repo — no la quieres activa cuando trabajas en otro cliente.

En vez de crear carpetas y archivos a mano, pégale estos prompts a Claude Code y deja que él cree la estructura correcta. Cambia solo la línea que dice Skill: por lo que quieras instalar.

Instálame esta skill de forma GLOBAL, en ~/.claude/skills/. Quiero que esté disponible en TODOS mis proyectos de Claude Code, sin tener que volver a instalarla.

Skill: <pega aquí el link del repo, el contenido del SKILL.md o el nombre exacto>

Pasos que quiero que ejecutes:
1. Crea la carpeta ~/.claude/skills/<nombre-skill>/ (minúsculas, con guiones).
2. Dentro, crea un archivo SKILL.md con frontmatter correcto:
   ---
   name: <nombre exacto>
   description: <una línea con los triggers que la activan — palabras clave, tipos de archivo, dominios>
   ---
3. Pega el contenido completo de la skill debajo del frontmatter.
4. Si la skill trae scripts, assets o templates extra, cópialos dentro de la misma carpeta.
5. Verifica abriendo Claude Code en OTRO proyecto cualquiera — la skill tiene que aparecer en la lista de available skills.
6. Confírmame en qué ruta quedó y qué archivos creaste.

Regla: NO la instales en .claude/skills/ de ningún proyecto. Esta es global.

Instálame esta skill SOLO en este proyecto, en .claude/skills/ del directorio actual. No la quiero global — no tiene sentido que cargue en todos mis proyectos.

Skill: <pega aquí el link del repo, el contenido del SKILL.md o el nombre exacto>

Pasos que quiero que ejecutes:
1. Crea .claude/skills/<nombre-skill>/ en la raíz de ESTE proyecto (no en ~/.claude).
2. Dentro, crea SKILL.md con frontmatter:
   ---
   name: <nombre exacto>
   description: <triggers claros — palabras, archivos, dominios que la activan>
   ---
3. Pega el contenido completo de la skill debajo.
4. Copia scripts, assets o templates auxiliares dentro de la misma carpeta.
5. Verifica abriendo Claude Code en este proyecto — la skill aparece.
6. Abre Claude Code en OTRO proyecto distinto y confirma que la skill NO aparece ahí.

Al terminar: confirma la ruta donde quedó y que solo vive aquí.

Si ya tienes muchas skills globales, probablemente la mitad deberían vivir en un proyecto. Estos dos prompts te hacen la limpieza: uno audita y otro mueve una skill específica de global a proyecto.

Audita mis skills globales en ~/.claude/skills/ y dime cuáles debería mover a proyectos específicos. No muevas ni borres nada todavía — solo recomienda.

Para cada carpeta de skill que encuentres:
1. Lee el SKILL.md y entiende qué hace, qué triggers tiene y qué archivos toca.
2. Clasifícala en uno de estos tiers:
   - QUEDA GLOBAL — es transversal (escritura, revisión de código, diseño UI, shortcuts, humanización). Tiene sentido en 3+ proyectos distintos.
   - MOVER A PROYECTO — es específica a un stack, formato o herramienta (PDFs, Playwright, un framework, un tipo de archivo concreto). Solo la usaría en 1-2 proyectos puntuales.
   - DUDOSA — no está claro; dime qué necesitas saber de mí para decidir.

Devuélveme una tabla con estas columnas:
| skill | tier | razón (1 línea) | si es MOVER: proyecto sugerido |

Si alguna skill está duplicada con otra o tiene frontmatter roto, márcalo al final en una sección aparte.

Mueve esta skill de global a por-proyecto — sácala de ~/.claude/skills/ y déjala solo en el proyecto destino.

Skill: <nombre-skill>
Proyecto destino: <ruta absoluta, por ejemplo /Users/yo/Desktop/mi-proyecto>

Pasos exactos:
1. Copia ~/.claude/skills/<nombre-skill>/ completa a <ruta-destino>/.claude/skills/<nombre-skill>/ — incluye SKILL.md, scripts, templates, todo.
2. Verifica archivo por archivo que el contenido llegó íntegro (compara tamaños y nombres).
3. Borra ~/.claude/skills/<nombre-skill>/ (la versión global).
4. Abre Claude Code en el proyecto destino — confirma que la skill aparece y responde a sus triggers.
5. Abre Claude Code en otro proyecto cualquiera — confirma que la skill YA NO aparece ahí.

Al terminar devuélveme un diff claro: qué había en global · qué quedó en el proyecto · qué se borró.

Hay gente que ya armó colecciones enteras. Úsalas como inventario — pero no las instales todas global de un jalón, o vas a ver lo mismo que tratamos de evitar.

• Superpowers

  colección

  Paquete de comandos y skills que le dan superpoderes a Claude Code.

  Es un bundle — trae varias skills y comandos juntos. Lo instalas como plugin, no como skill suelta.

  En la bóveda · 4 Superpoderes Claude

• GSD (Get Shit Done)

  colección

  Colección orientada a cerrar trabajo rápido: planning, ejecución, revisión.

  Igual que Superpowers: paquete completo. Decide si quieres que todo cargue global o solo en el proyecto donde estás empujando ese tipo de trabajo.

• awesome-claude-skills

  plugin/repo

  Catálogo curado de skills de la comunidad.

  No es UNA skill — es una lista. Eliges qué skills sacar de ahí y decides cada una: ¿global o proyecto?

  En la bóveda · Skill Vault (organiza tus skills)

• awesome-llm-apps

  plugin/repo

  Repo con 100+ agentes de IA en 13 categorías listos para instalar.

  Es un catálogo enorme. Saca solo los agentes que necesitas para un proyecto específico — no los dejes todos globales.

  En la bóveda · 100+ Agentes de IA

• Paquetes de Marketing / Agencia

  plugin/repo

  Bundles con muchos agentes y skills enfocados en marketing, ads, contenido.

  Traen skills + subagentes. Instálalos en el proyecto del cliente o en el repo de marketing — no los dejes globales o vas a ver agentes de ads cuando estés debuggeando tu app.

  En la bóveda · 29 Habilidades de Marketing