Un .pre-commit-config.yaml con rev: stable parece fijado, pero pre-commit nunca actualiza una revisión de rama, y cada clon nuevo recibe lo que esa rama contenga ese día. Un hook local cuyo entry es bash -c 'curl ... | sh' ejecuta un script descargado en cada commit, en el portátil de cada desarrollador. Un hook de gitleaks listado en ci: skip nunca escanea los commits que lo omitieron en local. Esta skill encuentra esos errores y los demás errores de git hooks que se indican abajo, y te dice cómo corregir cada uno.

Tu agente ejecuta un escáner sobre .pre-commit-config.yaml (con su sección ci: para pre-commit.ci) y .pre-commit-hooks.yaml, configuraciones de lefthook en YAML, JSON o TOML (incluidos los archivos lefthook-local y los remotes) y los scripts de .lefthook/, scripts de hooks de husky en .husky/, scripts de hooks en .githooks/ y carpetas similares, simple-git-hooks y la configuración antigua de husky en package.json, y los scripts de shell, Makefiles y scripts de package.json que instalan u omiten hooks. Ignora los comentarios, une las líneas continuadas, usa la propia prueba de pre-commit para revisiones de rama y trata $VAR y ${{ secrets.X }} como valores guardados fuera del archivo. Nunca ejecuta un hook, git ni ninguna herramienta y nunca usa la red. Devuelve BLOCK, REVIEW o NOT FLAGGED, con el archivo, la línea, el motivo y un enfoque más seguro. Los secretos nunca se muestran.

Qué comprueba

BLOCK (corregir antes de publicar)

• G01: repositorios de hooks obtenidos por http:// o git:// (repo: de pre-commit, git_url de remote de lefthook)
• G02: revisiones de pre-commit que indican una rama, HEAD, una etiqueta móvil o nada (rev: main, rev: stable, rev: '')
• G03: hooks que descargan código y lo ejecutan (curl o wget canalizados a una shell o a un intérprete que lee la descarga como su programa, sh -c "$(curl ...)", bash <(wget ...), iex (irm ...), o un archivo descargado que se ejecuta sin verificar su checksum); las indicaciones de instalación que un hook solo imprime no se cuentan
• G04: tokens, contraseñas y claves en configuraciones y scripts de hooks (valores de env, argumentos --token y --password, cabeceras Authorization, una contraseña en la URL de un repositorio, formatos de token conocidos); no se informan nombres de archivo, rutas ni palabras de configuración como enabled

REVIEW (revisar antes del lanzamiento)

• G11: revisiones de pre-commit fijadas a etiquetas en lugar de SHA de commits
• G12: remotes de lefthook sin ref o con una rama como ref
• G13: herramientas de hooks obtenidas sin versión (additional_dependencies, imágenes de Docker sin etiqueta o con :latest, npx --yes, bunx, pnpm y yarn dlx, uvx, pipx run, go run @latest)
• G14: proyectos con git hooks pero sin un hook de escaneo de secretos
• G15: escáneres de secretos omitidos en pre-commit.ci, limitados a la etapa manual, excluidos de todos los archivos o configurados con skip en lefthook
• G16: omisiones de hooks en scripts y mensajes de hooks (--no-verify, git commit -n, HUSKY=0, LEFTHOOK=0, SKIP= con el nombre de un escáner de secretos, core.hooksPath establecido en /dev/null)
• G17: scripts del proyecto que establecen core.hooksPath con --global o --system
• G18: comprobaciones de TLS o de clave de host desactivadas en hooks (curl -k, http.sslVerify false, NODE_TLS_REJECT_UNAUTHORIZED=0, --trusted-host y otras)
• G19: configuraciones de hooks que la herramienta nunca carga (configuración de husky v4 con husky 5 o posterior, .pre-commit-config.yml, dos configuraciones de lefthook en una misma carpeta)

Qué incluye

• El escáner (Python 3.9+, solo biblioteca estándar)
• Una guía de reglas con el motivo, el enfoque más seguro y la fuente oficial de cada regla
• Un ejemplo arriesgado y uno seguro (una API con pre-commit, una aplicación web con lefthook, una aplicación móvil con husky), y el informe real que genera el escáner sobre el ejemplo arriesgado

Límites

Lee cada archivo tal como está escrito. Los repositorios remotos de hooks y las configuraciones remotas de lefthook se nombran pero no se descargan, por lo que el código que aportan no se comprueba. No se leen los hooks ya instalados en .git/hooks, el core.hooksPath definido en tu configuración de git, los scripts que llama un hook ni los flujos de CI que ejecutan pre-commit. G11 (revisiones fijadas a etiquetas) y G14 (sin hook de escaneo de secretos) saltan en la mayoría de las configuraciones, incluidos el ejemplo de inicio rápido de pre-commit y los proyectos de husky por defecto; el agente los presenta como notas de refuerzo, no como problemas. G14 no puede ver el escaneo del lado del servidor, como GitHub push protection. NOT FLAGGED no es una garantía.

Contenido

Un archivo ZIP con 22 archivos: SKILL.md, el escáner en scripts/ (10 archivos de Python), references/rules.md (cada regla con su motivo y su enfoque más seguro) y examples/ (11 archivos de ejemplo más report.md, la salida real del escáner sobre el ejemplo arriesgado).

Cómo usarlo: Esto es una skill para agentes: una carpeta con un archivo SKILL.md y scripts de Python que puede ejecutar un agente de programación con IA como Claude Code, Cursor o Codex CLI. Descomprímela en la carpeta de skills de tu agente (para Claude Code: ~/.claude/skills/) y luego pide a tu agente que revise tu proyecto. Los scripts también funcionan por sí solos con Python 3.9 o posterior, sin nada que instalar. Solo leen tus archivos: sin acceso a la red, y no se envía nada a ningún sitio.