Crea Skills y Comandos Personalizados para Claude Code
Los Skills convierten prompts repetitivos en comandos reutilizables. Escribe un SKILL.md una vez, invócalo con /nombre-del-skill, y Claude Code ejecuta el flujo completo cada vez.
Los Skills son archivos markdown que definen flujos de trabajo reutilizables para Claude Code. En lugar de escribir el mismo prompt complejo cada vez que quieres desplegar, hacer una revisión de código o generar documentación, escribes un SKILL.md una vez y lo invocas con un comando slash.
Qué es un Skill de Claude Code
Un Skill es un archivo markdown (SKILL.md) que contiene instrucciones que Claude Code sigue cuando lo invocas. Puede incluir una descripción, restricciones de herramientas, configuración de contexto e instrucciones paso a paso. Piénsalo como un prompt guardado con superpoderes.
Cómo crear un Skill
Crea un archivo SKILL.md en el directorio .claude/skills/ de tu proyecto (compartido con el equipo) o en ~/.claude/skills/ (personal):
# .claude/skills/deploy.md
---
name: deploy
description: Desplegar la rama actual a staging
allowed-tools: Bash, Read
---
## Pasos
1. Ejecutar la suite de pruebas: `npm run test`
2. Si las pruebas pasan, compilar el proyecto: `npm run build`
3. Desplegar a staging: `npm run deploy:staging`
4. Verificar el despliegue comprobando el endpoint de salud
5. Publicar un resumen de lo que se desplegóAhora puedes invocarlo:
# En Claude Code
> /deployQué opciones de frontmatter están disponibles
| Opción | Qué hace | Ejemplo |
|---|---|---|
| name | Nombre del comando slash | deploy |
| description | Se muestra en la lista de skills | Desplegar a staging |
| allowed-tools | Restringe qué herramientas puede usar el skill | Bash, Read, Edit |
| disable-model-invocation | Previene llamadas anidadas de IA | true |
| context | Manejo de sesión | fork (se ejecuta en contexto aislado) |
Cuáles son buenos casos de uso para Skills
- +Flujos de trabajo de despliegue (probar, compilar, desplegar, verificar)
- +Checklists de revisión de código (seguridad, rendimiento, estilo)
- +Generación de documentación (documentos API, changelogs, READMEs)
- +Operaciones de base de datos (migración, seeding, backup)
- +Incorporación de nuevos miembros del equipo (tour del proyecto, verificación de setup)
- +Gestión de releases (bump de versión, changelog, tag, publicar)
Cómo usar variables en Skills
Los Skills soportan argumentos a través de $ARGUMENTS (texto completo) y variables posicionales ($0, $1, etc.):
# .claude/skills/create-component.md
---
name: create-component
description: Crear un nuevo componente React
---
Crea un nuevo componente React llamado $0 en el directorio de componentes.
Requisitos:
- TypeScript con interfaz de props adecuada
- Tailwind CSS para estilos
- Exportar como default
- Incluir prueba unitaria básica en __tests__/
Uso: /create-component UserProfileInvocar con argumentos
# Argumento único
> /create-component UserProfile
# Múltiples argumentos
> /create-component UserProfile --with-tests --with-storyCómo compartir Skills con tu equipo
Coloca los Skills en el directorio .claude/skills/ de tu proyecto y commitéalos a git. Cada desarrollador que clone el repo obtiene los mismos skills. Los skills personales van en ~/.claude/skills/ y no se comparten.
Los Skills componen bien con los Hooks. Por ejemplo, un skill de "deploy" puede activar un hook PostToolUse que envíe una notificación a Slack después del despliegue. Construye tu automatización en capas.