📁 .claude/skills/ del proyecto
El directorio .claude/skills/ queda en la raíz de tu repositorio. Las skills allí tienen alcance local: existen solo para quienes trabajan en ese proyecto específico.
El directorio .claude/skills/ en la raíz del repositorio está el espacio de skills con alcance de proyecto. Toda skill colocada allí está disponible solo cuando Claude Code se ejecuta dentro de ese repo.
Cada skill es una subcarpeta. El nombre de la carpeta es exactamente el nombre por el que Claude la reconoce; p. ej.: .claude/skills/video-explicativo/.
- ✓ La skill es específica para ese producto o cliente
- ✓ Quieres versionar la skill junto con el código
- ✓ Todo el equipo debe usar la misma versión de la skill
- ✓ La skill cambia en cada sprint junto con el proyecto
- ✗ La skill sirve para todos tus proyectos personales
- ✗ El repo es público y la skill contiene datos sensibles
- ✗ Estás probando un borrador temporal
- ✗ La skill debe funcionar fuera de cualquier proyecto
🌐 ~/.claude/skills/ global
El directorio global está en ~/.claude/skills/ (página principal del usuario). Las Skills que están allí se aplican absolutamente a cualquier proyecto que abras en la máquina.
- • Dentro del repositorio
- • Versionado en git
- • Compartido con el equipo mediante clone
- • Alcance: solo este proyecto
- • En la página de inicio del usuario
- • Fuera de cualquier repo
- • Solo en tu máquina (no se clona)
- • Alcance: todos los proyectos
Si existe una skill con el mismo nombre en ambos lugares (local y global), la versión local (.claude/skills/) tiene prioridad. Aprovéchalo: coloca en el proyecto una versión personalizada de una skill que normalmente usas de forma global.
📋 Instalar copiando la carpeta
La forma más sencilla de instalar una skill es copiar la carpeta, desde un git clone — al directorio correcto. Así es exactamente como instalas la skill video-explicativo de este curso.
La skill puede venir de un repositorio propio (github.com/inematds/video-explicativo), de una carpeta comprimida o simplemente de una carpeta enviada por alguien del equipo. El contenido mínimo siempre es: SKILL.md en la raíz de la carpeta.
git clone https://github.com/inematds/video-explicativo. La skill está en skills/video-explicativo/ — es esta carpeta (con el SKILL.md en su raíz) que mueves, no todo el repo.
Para el alcance local: mv video-explicativo/ .claude/skills/. Para el ámbito global: mv video-explicativo/ ~/.claude/skills/. Crea el directorio si no existe: mkdir -p .claude/skills/.
Abre Claude Code en la sesión del proyecto. La skill ya estará disponible — basta con invocarla por el nombre configurado en SKILL.md. No se necesita reiniciar ni recargar.
No hay binarios, no hay build, no hay dependencias npm que instalar. Una skill es 100 % archivos de texto: markdown, scripts shell, templates. Copiar la carpeta ES la instalación completa.
⌨️ Por comando
Además de copiarlas manualmente, puedes instalar skills mediante CLI, como npx skills add — que accede a un catálogo centralizado y descarga automáticamente.
Herramientas como npx skills add <nome> automatizan el proceso de copiar manualmente: buscan el paquete en el catálogo, lo descargan y lo colocan automáticamente en el lugar correcto.
Es el mismo patrón de npm install pero para skills de Claude Code: sin package.json, sin node_modules, solo la carpeta de la skill.
- ✓ Skills públicas del catálogo oficial
- ✓ Quieres garantizar la versión más reciente
- ✓ El equipo nuevo necesita configurar el entorno rápidamente
- ✓ Quieres explorar el catálogo de skills disponibles
- ✗ Skills internas/privadas de la empresa (no publicadas)
- ✗ Necesitas una versión personalizada específica
- ✗ Entorno sin acceso a Internet
- ✗ La skill todavía está en desarrollo local
🔁 Versionar en git
Una skill es texto plano, por lo que se integra de forma natural en git. Esto significa historial, diff, revisión de PR, rollback y trazabilidad completa de quién cambió qué en la skill.
Cuando la skill y el código evolucionan juntos en el mismo commit, siempre sabes exactamente qué versión de la skill produjo cada resultado. Nunca más "la skill cambió y el video quedó diferente" sin poder rastrearlo.
Skills en ~/.claude/skills/ quedan fuera de cualquier repositorio y NO se versionan automáticamente. Si quieres una copia de seguridad o un historial de tu skill global, crea un repositorio dedicado (p. ej.: meus-skills-pessoais/) y sincroniza manualmente.
Escribe SKILL.md + referencias → git add + commit
Corrige el prompt, agrega una referencia → nuevo commit — diff visible en el PR
El equipo revisa los cambios en la skill igual que revisa el código: comentarios línea por línea
git tag v1.2-skill — congela el skill en un estado estable para producción
🤝 Compartir con el equipo
Skill en el repositorio significa que cada desarrollador que clone el proyecto recibe automáticamente las mismas skills — sin instalación manual ni divergencias entre máquinas.
Cuando la skill está en .claude/skills/ en el repositorio, cualquier git clone incluye el entorno completo. ¿Nuevo desarrollador en el equipo? Clona el repo y ya tienes la skill. ¿Máquina nueva? Clona y ya funciona.
Esto elimina la pregunta «¿qué versión del skill estás usando?» — todos usan exactamente lo que está en el commit actual del repo.
- ✓ Documenta el skill en el README: qué es y cómo invocarlo
- ✓ Incluye ejemplos reales de uso en el SKILL.md
- ✓ Usa PR para cualquier cambio en la skill (revisión)
- ✓ Mantén las referencias actualizadas cuando cambie el proyecto
- ✗ Incluir claves de API o tokens dentro de la skill en un commit
- ✗ Skill con rutas absolutas que solo existen en tu máquina
- ✗ Modificar la skill sin comunicar los cambios al equipo
- ✗ Skill que depende de software no listado en los requisitos previos
git clone <repo>ls .claude/skills/El SKILL.md de la skill no es solo instrucciones para Claude: es documentación real de lo que usa el equipo y cómo lo usa. Mantenlo tan actualizado como mantendrías un README de una función crítica.
📚 Resumen del Módulo 1.4
Completaste la Ruta 1 — Skills. Esto es todo lo que dominas:
.claude/skills/ del proyecto — alcance limitado al repositorio
~/.claude/skills/ — disponibles en cualquier proyecto de la máquina
npx skills add automatizan la descarga del catálogo
Ruta 2 — Pipeline. Descubre el framework open-source que transforma HTML animado en MP4 local, sin nube y sin costo por render, y cómo se conecta con todo lo que aprendiste sobre skills en la Ruta 1.