claude-skills

Repositorio de Skills listas para usar con Claude Code en proyectos Java/Gradle. Complementa la serie de tutoriales en javatutoriales.com.

Skills incluidas

Del tutorial (5)

Skill	Comando	Cuándo se activa
tdd-spring	/tdd-spring	Tests JUnit 5, Mockito, Testcontainers
db-migration	/db-migration	Flyway, migraciones SQL
spring-performance	/spring-performance	N+1, startup lento, HikariCP
code-review	/code-review	Code reviews y PRs
technical-docs	/technical-docs	ADRs, READMEs, OpenAPI

Adicionales (12)

Skill	Comando	Cuándo se activa
java-migration-21	/java-migration-21	Virtual threads, records, Java 21
spring-security	/spring-security	JWT, OAuth2, CORS, autorización
jpa-patterns	/jpa-patterns	Fetching, N+1, JPQL, projections
api-design	/api-design	REST endpoints, OpenAPI, paginación
refactoring	/refactoring	Code smells, complejidad, patrones
git-workflow	/git-workflow	Branches, commits, PRs, rebase
debugging	/debugging	Bugs, stack traces, diagnóstico
observability	/observability	Logging, métricas, trazas distribuidas
incident-response	/incident-response	Incidentes de producción, postmortem
dependency-upgrade	/dependency-upgrade	Actualización de dependencias Gradle
security-scan-backend	/security-scan-backend	Revisión de buenas prácticas de seguridad para el backend
security-scan-frontend	/security-scan-frontend	Revisión de buenas prácticas de seguridad para el frontend

Estructura de cada Skill

.claude/skills/<nombre>/
├── SKILL.md              ← Punto de entrada — instrucciones y frontmatter
├── scripts/              ← Scripts ejecutables (solo el output va al contexto)
├── templates/            ← Plantillas que Claude completa
├── references/           ← Documentación detallada (cargada bajo demanda)
└── examples/             ← Ejemplos de output esperado

Instalación rápida

# Copia el directorio .claude/skills/ a la raíz de tu proyecto
cp -r .claude/skills/ /ruta/a/tu/proyecto/.claude/

# Da permisos de ejecución a todos los scripts
chmod +x /ruta/a/tu/proyecto/.claude/skills/*/scripts/*.sh

# O usa el instalador interactivo
bash install.sh

Instalación con el script

bash install.sh

El instalador pregunta qué Skills instalar y si sobreescribir las existentes.

Personalización

Cada Skill está diseñada para ser editada. Los puntos más comunes de personalización:

1. Nombres de paquetes — actualiza las referencias a com.miempresa.*
2. Versiones de dependencias — actualiza los números de versión
3. Convenciones del equipo — edita las secciones de "Reglas del equipo"
4. Scripts — ajusta los paths de logs y configuraciones

Verificar Skills activas en Claude Code

/project:tdd-spring    ← invocar manualmente
¿Qué skills tienes disponibles?  ← pregunta al agente

Recursos

• Claude Code — Documentación oficial de Skills
• Agent Skills Standard
• Serie de tutoriales Claude Code — javatutoriales.com