setup-pre-commit

Resumen de la skill setup-pre-commit

La skill setup-pre-commit te ayuda a montar un flujo práctico de hooks de Git: comprobaciones de Husky en pre-commit, formato con lint-staged y Prettier, y ejecuciones opcionales de typecheck y tests antes de que el código quede registrado en un commit. Es ideal para repositorios que ya usan una herramienta basada en Node y necesitan una configuración rápida y repetible, en lugar de construir el hook a mano.

Para qué sirve setup-pre-commit

Usa la skill setup-pre-commit cuando quieras una red de seguridad en el momento del commit que estandarice el formato y detecte fallos evidentes cuanto antes. El trabajo real no es “instalar Husky” de forma aislada, sino hacer que los commits locales sean más seguros sin obligarte a rediseñar el repositorio.

Cuándo encaja especialmente bien

Es una buena opción si tu repositorio ya usa, o puede usar, scripts de Prettier, typecheck y test, y quieres una convención sencilla que funcione con npm, pnpm, Yarn o Bun. También resulta útil cuando necesitas una configuración que se pueda aplicar rápido en un proyecto ya existente, con el mínimo debate de políticas.

Cuáles son sus límites

Esta skill aporta menos si tu proyecto no está basado en Node, si quieres lógica de commit-msg o pre-push en lugar de pre-commit, o si tus comprobaciones requieren una orquestación personalizada más allá de un hook sencillo. También asume que te sientes cómodo verificando qué scripts existen antes de añadirlos al hook.

Cómo usar la skill setup-pre-commit

Instala y abre los archivos correctos

Instálala con npx skills add mattpocock/skills --skill setup-pre-commit. Luego lee primero SKILL.md, porque ahí está el flujo de trabajo real y los puntos de decisión. Si tu vista del directorio solo muestra un archivo, eso basta para seguir la configuración, pero aun así conviene revisar el árbol del repositorio en busca de pistas sobre el gestor de paquetes y los scripts disponibles.

Dale el contexto correcto del repositorio

Para obtener mejores resultados, indícale a la skill qué lockfile existe, si package.json ya tiene typecheck y test, y si Prettier ya está configurado. Una petición sólida sería: “Configura setup-pre-commit en este repo usando pnpm; mantén la configuración actual de Prettier; añade solo los scripts que ya existan”. Eso es mejor que decir simplemente “añade hooks pre-commit”, porque elimina las dudas sobre el gestor de paquetes y el contenido del hook.

Sigue el flujo en el orden correcto

La skill está diseñada alrededor de una secuencia simple: detectar el gestor de paquetes, instalar las dependencias de desarrollo, inicializar Husky, escribir .husky/pre-commit, añadir lint-staged y crear o reutilizar una configuración de Prettier. En la práctica, la decisión importante es si incluir npm run typecheck y npm run test o dejarlos fuera cuando esos scripts no existan. Esa elección mantiene el hook útil en lugar de frágil.

Patrón práctico de prompt

Usa un prompt que nombre el estado del repositorio y la política deseada. Por ejemplo: “Usa setup-pre-commit para añadir Husky, lint-staged y Prettier a este monorepo. El lockfile es pnpm-lock.yaml, existe typecheck, no existe test, y ya hay un .prettierrc.” Eso le da a la skill suficiente detalle para generar una configuración correcta sin inventar scripts ni sobrescribir ajustes.

Preguntas frecuentes sobre la skill setup-pre-commit

¿setup-pre-commit es solo para repositorios nuevos?

No. La skill setup-pre-commit suele ser incluso más valiosa en repositorios existentes, porque te ayuda a añadir una política de hooks coherente sin reconstruir archivos a mano. Funciona mejor cuando ya sabes qué scripts y qué configuración hay presentes.

¿Necesito tanto Husky como lint-staged?

Para este flujo, sí: esa es precisamente la idea. Husky dispara el hook, y lint-staged limita el formateo a los archivos staged para que los commits sigan siendo rápidos. Si solo quieres una de esas piezas, quizá te convenga más un prompt genérico que la skill setup-pre-commit.

¿Sobrescribirá mi configuración de Prettier?

No debería hacerlo si se usa con cuidado. La skill crea .prettierrc solo cuando falta, y la decisión principal es si tu repositorio ya tiene una configuración de formateo que conviene conservar. Si tienes una política de estilo existente, menciónala explícitamente.

¿Sirve para CI o solo para commits locales?

Su valor principal está en la aplicación local antes del commit, pero las mismas comprobaciones suelen reflejar las expectativas de CI. Si tu CI usa comandos distintos, evita copiar el hook sin más: alinéalo con los scripts que realmente ejecuta tu pipeline. Esta es la principal cuestión de setup-pre-commit for CI Troubleshooting.

Cómo mejorar la skill setup-pre-commit

Dale a la skill las restricciones reales de tu repositorio

La mejora más grande llega cuando le dices a setup-pre-commit qué gestor de paquetes, scripts y archivos de configuración ya existen. Si falta ese contexto, es fácil acabar con prefijos de comando incorrectos, creación innecesaria de scripts o pasos del hook que fallan en el primer commit.

Evita los fallos más comunes del hook

El fallo más habitual es añadir typecheck o test a .husky/pre-commit cuando esos scripts no existen. Otro problema frecuente es formatear todos los archivos en vez de solo los staged, lo que hace que los commits sean más lentos de lo necesario. Si quieres que el hook sea fiable, especifica qué debe pasar cuando falta un script.

Mejora la primera salida con objetivos explícitos

Pide resultados concretos, no solo instalación. Una instrucción mejor sería: “Añade hooks pre-commit de Husky que ejecuten lint-staged sobre los archivos staged, conserva la configuración existente de Prettier e incluye typecheck solo si package.json ya lo define”. Eso produce un resultado de setup-pre-commit guide mucho más útil que una solicitud vaga.

Itera después del primer paso

Tras la configuración inicial, comprueba si el hook encaja con las expectativas del equipo en velocidad y nivel de exigencia. Si resulta demasiado pesado, mueve las comprobaciones costosas fuera de pre-commit y llévalas a CI; si queda demasiado laxo, añade el script que falta o reduce el alcance de lint-staged. El mejor resultado de setup-pre-commit install es el que tu equipo realmente va a seguir usando.