¿Qué son los skills de Claude Code?
Si usas Claude Code en el terminal, ya sabes que puedes pedirle que escriba código, explique errores o refactorice funciones. Pero hay un nivel superior: los skills. Un skill es básicamente un comando personalizado (una especie de macro con instrucciones detalladas) que le dices a Claude cómo ejecutar en cualquier momento con un /nombre.
La diferencia entre pedirle algo a Claude en texto libre y tener un skill configurado es la misma que hay entre explicarle a un colaborador nuevo qué quieres cada vez que lo necesitas, versus tener un proceso documentado que cualquiera puede seguir sin explicaciones. El skill incorpora contexto, convenciones y pasos concretos. Tú solo tienes que invocarlo.
Los skills se definen en archivos Markdown dentro de la carpeta .claude/skills/ de tu proyecto, o globalmente en ~/.claude/skills/ para usarlos en cualquier repositorio.
Cómo funciona un skill por dentro
Un skill es un archivo .md con un frontmatter YAML que define el nombre, descripción y comportamiento, seguido de las instrucciones en Markdown. Claude lo lee completo cada vez que invocas el comando, así que cuanto más preciso sea, mejor.
Un ejemplo mínimo para generar mensajes de commit siguiendo Conventional Commits:
---
name: commit
description: Genera un mensaje de commit siguiendo Conventional Commits
---
Analiza los cambios en staging (git diff --cached) y propón un mensaje de commit.
Sigue este formato:
- tipo(scope): descripción corta en imperativo, máx 72 chars
- Tipos válidos: feat, fix, refactor, docs, style, test, chore
- Si hay breaking changes, añade BREAKING CHANGE: en el footer
- No incluyas el Co-Authored-By por defecto
Muestra el mensaje propuesto y pregunta si lo confirmo antes de hacer el commit.
Con esto, en cualquier repo puedo escribir /commit y Claude revisa el diff, genera el mensaje correcto y me lo confirma antes de ejecutar. Cero fricción, convenciones siempre correctas.
Los skills que uso cada día
1. /pr-description — Descripciones de PR que la gente realmente lee
Uno de los mayores desperdicios de tiempo en equipos es escribir descripciones de Pull Request decentes. Con este skill, Claude analiza todos los commits del branch respecto a main, lee los archivos modificados y genera una descripción estructurada con resumen, cambios clave, impacto en producción y checklist de QA. Lo que antes me llevaba 10 minutos ahora tarda 20 segundos.
El skill incluye instrucciones para adaptar el tono al tipo de cambio (feature, bugfix, refactor) y añadir screenshots si detecta cambios en componentes UI.
2. /review — Code review con el contexto de tu proyecto
Un code review genérico te dice si hay problemas obvios de rendimiento o legibilidad. Un code review con contexto te dice si el código viola las convenciones específicas de tu proyecto, si introduce patrones inconsistentes con el resto de la codebase, o si hay edge cases que tu lógica de negocio particular hace relevantes.
El skill /review que uso carga el CLAUDE.md del proyecto (donde tengo documentadas las convenciones), revisa el diff y genera un informe estructurado con: bloqueantes, mejoras recomendadas y sugerencias opcionales. Tres categorías claras, sin ruido.
3. /test — Genera tests que cubren lo que importa
Pedir a Claude "escribe tests para esta función" sin contexto produce tests triviales que verifican lo obvio. El skill /test incluye instrucciones sobre el framework que uso (Vitest + Testing Library), el patrón AAA (Arrange, Act, Assert), los casos edge que siempre hay que cubrir para mi stack específico, y cómo nombrar los describes e its de forma consistente con el resto del proyecto.
El resultado es tests que realmente me dan confianza, no tests que solo suben el coverage counter.
4. /debug — Diagnóstico sistemático en vez de prueba y error
Cuando algo falla, el impulso natural es cambiar cosas al azar hasta que funcione. El skill /debug me fuerza (y a Claude) a seguir un proceso: reproducir el error de forma mínima, identificar la última versión que funcionaba, listar las hipótesis ordenadas por probabilidad, y probar cada una de forma aislada. Es el método científico aplicado al debugging, y funciona mejor de lo que parece.
5. /docs — Documentación que alguien leerá
Documentar mientras desarrollas es difícil. Documentar después es más difícil aún porque ya no tienes frescas las decisiones que tomaste. El skill /docs analiza el archivo o módulo que le señalas y genera documentación en el formato específico de tu proyecto: JSDoc para funciones, README actualizado para módulos, o comentarios inline para lógica no obvia. Especialmente útil para APIs públicas.
Skills que vale la pena instalar globalmente
Además de los skills específicos de proyecto, hay algunos que tienen sentido instalar globalmente porque funcionan en cualquier codebase:
| Skill | Qué hace | Cuándo usarlo |
|---|---|---|
/explain |
Explica el código seleccionado en lenguaje llano | Al incorporarte a un proyecto nuevo |
/security |
Audita vulnerabilidades en el código actual | Antes de cada release o deploy |
/perf |
Analiza cuellos de botella y propone optimizaciones | Cuando algo va lento y no sabes por qué |
/migrate |
Ayuda a migrar entre versiones de librerías | Al actualizar dependencias mayores |
/changelog |
Genera el CHANGELOG desde los commits | En cada release |
Cómo configurar tu primer skill en 5 minutos
Si tienes Claude Code instalado, añadir tu primer skill es trivial:
# Crear la carpeta de skills del proyecto
mkdir -p .claude/skills
# Crear el skill
cat > .claude/skills/commit.md << 'EOF'
---
name: commit
description: Genera mensaje de commit con Conventional Commits
---
Revisa git diff --cached y genera un mensaje de commit preciso.
Formato: tipo(scope): descripción en imperativo, máx 72 chars.
Tipos: feat, fix, refactor, docs, test, chore, style.
Confírmame el mensaje antes de ejecutar git commit.
EOF
La próxima vez que escribas /commit en Claude Code, ejecutará exactamente esas instrucciones.
El ROI real de invertir en skills
Configurar un skill bien tarda entre 20 y 45 minutos la primera vez. Si lo usas 5 veces al día y cada uso te ahorra 3 minutos respecto a escribir la petición desde cero, recuperas la inversión en dos días. A partir de ahí, son minutos ganados cada jornada con cero esfuerzo adicional.
Pero el beneficio no es solo tiempo. Es consistencia. Cuando el skill está bien definido, el output de Claude es predecible y sigue las convenciones de tu equipo. No importa si lo invocas tú, un compañero de equipo, o si lo usas en un proyecto que no has tocado en seis meses. El comportamiento es siempre el mismo.
El límite real: CLAUDE.md como base de todo
Los skills son potentes, pero su efectividad depende de que el archivo CLAUDE.md de tu proyecto esté bien escrito. Es el documento que Claude lee al inicio de cada sesión para entender el contexto: stack tecnológico, convenciones de código, comandos de build y test, decisiones arquitectónicas. Sin ese contexto, incluso el mejor skill produce outputs genéricos.
Mi recomendación: antes de configurar skills, dedica una hora a escribir un buen CLAUDE.md. Es la mejor inversión que puedes hacer en tu flujo de trabajo con IA.
¿Quieres un setup inicial para tu proyecto?
Si quieres que te ayude a configurar Claude Code con skills adaptados a tu stack y flujo de trabajo específico, escríbeme. En una sesión de trabajo puedo dejarte un setup que uses desde el primer día.