Saltar al contenido
Lección 8 de 12

Automatizando la Repeticion — Skills, Hooks y Flujos de Trabajo

8 min read

Cada Tarea Repetitiva Es una Fuga de Productividad

Observate trabajar durante un dia y cuenta cuantas veces haces lo mismo. Ejecutar el linter antes de hacer commit. Escribir el mismo formato de descripcion de PR. Formatear codigo despues de generarlo. Verificar que los imports esten ordenados. Ejecutar el mismo comando de test con los mismos flags. Cada ocurrencia toma de 30 segundos a 2 minutos. A lo largo de un dia, estas fugas suman 30-60 minutos de pura sobrecarga.

El enfoque 5.7x tiene una regla simple: automatiza en la tercera ocurrencia. La primera vez que haces algo manualmente, esta bien. La segunda vez, anotalo. La tercera vez, automatizalo. Una vez automatizado, nunca vuelve a costar tiempo.

Claude Code proporciona tres capas de automatizacion: skills para flujos de trabajo recurrentes complejos, hooks para puertas de calidad automaticas y comandos personalizados para atajos especificos del proyecto.

Skills: Plantillas de Flujo de Trabajo Reutilizables

Los skills son archivos markdown que describen como realizar una tarea especifica. Claude Code los lee automaticamente cuando son relevantes, dando a la IA el conocimiento para ejecutar flujos de trabajo complejos de forma consistente.

Crea skills en el directorio .claude/skills/ de tu proyecto:

<!-- .claude/skills/deploy.md -->
# Skill de Despliegue

Cuando se pida desplegar, sigue estos pasos:

1. Ejecutar la suite de tests: `npm test`
2. Si los tests fallan, corregir los problemas antes de continuar
3. Ejecutar el linter: `npm run lint`
4. Construir el proyecto: `npm run build`
5. Si el build tiene exito, hacer commit de cambios pendientes
6. Push a la rama principal: `git push origin main`
7. Verificar que el despliegue de Vercel inicio revisando git status
8. Reportar la URL de despliegue

Ahora cuando dices "despliega," Claude Code sigue el proceso exacto cada vez:

claude "despliega"
# Claude lee el skill y ejecuta los 8 pasos automaticamente

Mas Ejemplos de Skills

Skill de revision de codigo:

<!-- .claude/skills/review.md -->
# Skill de Revision de Codigo

Cuando se pida revisar codigo o un PR:

1. Leer todos los archivos cambiados usando `git diff`
2. Verificar:
   - Problemas de seguridad de tipos
   - Falta de manejo de errores
   - Convenciones de nombres inconsistentes
   - Tests faltantes para funcionalidad nueva
   - Preocupaciones de seguridad (secretos expuestos, inyeccion SQL, XSS)
   - Problemas de rendimiento (queries N+1, re-renders innecesarios)
3. Organizar hallazgos por severidad: critico, advertencia, sugerencia
4. Proporcionar referencias de linea especificas y sugerencias de correccion

Skill de nueva leccion:

<!-- .claude/skills/new-lesson.md -->
# Skill de Nueva Leccion

Al crear una nueva leccion de curso:

1. Verificar lecciones existentes en el directorio del curso para numeracion
2. Crear archivos .en.mdx y .es.mdx
3. Incluir frontmatter: title, description, date, tags, category, order, course
4. Estructurar contenido con ## para secciones principales, ### para subsecciones
5. Objetivo de 800-1200 palabras por leccion
6. Incluir ejemplos de codigo donde sea relevante
7. Asegurar que la version en espanol sea una traduccion completa, no un resumen

Hooks: Puertas de Calidad Automaticas

Los hooks se ejecutan automaticamente cuando ocurren eventos especificos en Claude Code. Son tu capa de cumplimiento de calidad automatizado.

Hooks Pre-Commit

Configura hooks que se ejecuten antes de cada commit para capturar problemas automaticamente:

// .claude/hooks.json
{
  "pre-commit": [
    {
      "command": "npm run lint",
      "description": "Ejecutar linter antes de hacer commit"
    },
    {
      "command": "npm run typecheck",
      "description": "Verificar tipos de TypeScript"
    },
    {
      "command": "npm test -- --changed",
      "description": "Ejecutar tests en archivos cambiados"
    }
  ]
}

Con estos hooks en su lugar, cada commit pasa automaticamente por linting, verificacion de tipos y testing. Sin paso manual requerido, sin posibilidad de olvidar.

Hooks Post-Write

Los hooks tambien pueden ejecutarse despues de que la IA escribe o modifica archivos:

{
  "post-write": [
    {
      "pattern": "*.tsx",
      "command": "npx prettier --write",
      "description": "Auto-formatear componentes React despues de cambios"
    },
    {
      "pattern": "*.css",
      "command": "npx prettier --write",
      "description": "Auto-formatear CSS despues de cambios"
    }
  ]
}

Esto significa que cada archivo que la IA crea se formatea automaticamente. Nunca necesitas pensar en formato de nuevo.

Comandos Personalizados para Atajos del Proyecto

Mas alla de skills y hooks, crea comandos slash personalizados para tareas especificas de tu proyecto:

<!-- .claude/commands/new-course.md -->
# /new-course

Crear un nuevo curso con la siguiente estructura:

Argumentos: $COURSE_NAME, $LESSON_COUNT

1. Crear directorio: src/content/courses/$COURSE_NAME/
2. Crear _meta.en.mdx y _meta.es.mdx con metadatos del curso
3. Crear $LESSON_COUNT archivos de leccion (tanto .en.mdx como .es.mdx)
4. Cada archivo de leccion debe tener frontmatter correcto con orden secuencial
5. Generar esquemas de contenido inicial para cada leccion

Uso:

claude "/new-course ai-security 10"
# Crea la estructura completa del curso con 22 archivos

Ejemplo Real: El Flujo de Trabajo /deploy

Asi funciona en la practica una automatizacion de despliegue completa:

# Antes de la automatizacion: checklist manual de despliegue
# 1. Recordar ejecutar tests (a veces se olvida)
# 2. Recordar lint (frecuentemente se omite)
# 3. Recordar hacer build local (errores se detectan tarde)
# 4. Hacer commit manualmente con un mensaje
# 5. Push a main
# 6. Revisar dashboard de Vercel para estado del despliegue
# 7. Probar la URL de produccion
# Tiempo total: 8-12 minutos, propenso a errores

# Despues de la automatizacion: un comando
claude "despliega los cambios actuales"
# Claude lee el skill de deploy y ejecuta cada paso
# Tiempo total: 3-4 minutos, sin pasos omitidos

Tiempo ahorrado por despliegue: 5-8 minutos. Si despliegas 3-4 veces por dia, eso es 15-32 minutos ahorrados diariamente. En un mes, eso es 5-10 horas recuperadas de una sola automatizacion.

La Regla de "Automatiza en la Tercera Ocurrencia"

Aqui esta el proceso practico:

  1. Primera ocurrencia: Haz la tarea manualmente. Nota los pasos involucrados.
  2. Segunda ocurrencia: Hazla manualmente de nuevo. Escribe los pasos esta vez.
  3. Tercera ocurrencia: Antes de hacerla, crea un skill, hook o comando. Luego usa la automatizacion.

Esta regla previene dos modos de falla:

  • Automatizacion prematura: Automatizar algo que haces una vez desperdicia mas tiempo del que ahorra.
  • Trabajo manual cronico: Hacer lo mismo 50 veces manualmente cuando 5 minutos de configuracion lo habrian automatizado.

Tareas comunes que alcanzan la tercera ocurrencia rapidamente:

| Tarea | Tipo de Automatizacion | Tiempo de Config | Tiempo Ahorrado por Uso | |-------|----------------------|------------------|--------------------------| | Verificaciones pre-commit | Hook | 5 minutos | 2-3 minutos | | Formato de codigo | Hook post-write | 3 minutos | 30 segundos | | Creacion de PR | Skill | 10 minutos | 5-8 minutos | | Scaffolding de curso | Comando personalizado | 15 minutos | 20-30 minutos | | Despliegue | Skill | 10 minutos | 5-8 minutos | | Revision de codigo | Skill | 10 minutos | 15-20 minutos |

Construyendo una Biblioteca Personal de Automatizacion

Con el tiempo, tu coleccion de skills, hooks y comandos se convierte en una biblioteca personal de automatizacion. Esta biblioteca es una gran ventaja competitiva -- significa que cada proyecto que inicias se beneficia de cada automatizacion que hayas construido.

Estructura tu biblioteca de automatizacion:

.claude/
  skills/
    deploy.md           # Flujo de trabajo de despliegue
    review.md           # Proceso de revision de codigo
    new-lesson.md       # Creacion de contenido
    refactor.md         # Pasos de refactorizacion segura
    debug.md            # Depuracion sistematica
  hooks.json            # Puertas de calidad automaticas
  commands/
    new-course.md       # Scaffolding de curso
    new-component.md    # Creacion de componente
    new-api-route.md    # Scaffolding de ruta de API

Consejos para mantener tu biblioteca:

  • Mantén los skills enfocados en una tarea cada uno
  • Actualiza los skills cuando tu proceso cambie
  • Comparte skills utiles entre proyectos via un repositorio de plantillas
  • Documenta el "por que" en tus skills, no solo el "que"

Midiendo el Tiempo Ahorrado

Rastrea el impacto de tus automatizaciones para justificar la inversion e identificar que automatizar despues:

## Registro de Automatizacion

### Semana del 24 de marzo, 2026
- skill de deploy: usado 12 veces, ahorro ~72 minutos
- skill de review: usado 5 veces, ahorro ~75 minutos
- hooks pre-commit: activados 28 veces, detectaron 4 problemas temprano
- hooks de formato: activados ~200 veces, estimado 60 minutos ahorrados

Tiempo total ahorrado esta semana: ~3.5 horas
Tiempo total de configuracion invertido: ~1 hora (acumulativo)
ROI: 3.5x de retorno solo en la primera semana

El retorno de inversion en automatizacion es casi siempre positivo para la segunda semana. Para el segundo mes, las horas acumuladas ahorradas son significativas. Y a diferencia del trabajo manual, las automatizaciones continuan ahorrando tiempo indefinidamente una vez creadas.

Este es el principio 5.7x aplicado a tu propio flujo de trabajo: en lugar de ejecutar manualmente tareas repetitivas, describelas una vez en un skill o hook y deja que la automatizacion las maneje para siempre. El tiempo que inviertes en automatizacion se acumula en un aumento permanente de productividad.