Un push falla porque un archivo de modelo de 120 MiB se coló en el último commit. Un compañero en Windows clona el repositorio y git se detiene con "invalid path 'lib/aux.js'". Un contenedor termina con "exec /entrypoint.sh: no such file or directory" porque el script se subió con finales de línea CRLF. Un archivo .env que aparece en .gitignore se subió antes de que existiera la regla, y todos los forks lo siguen recibiendo. Esta skill detecta esos y los demás errores de higiene del repositorio que se indican abajo, y te explica cómo corregir cada uno.

Tu agente ejecuta un escáner sobre la carpeta del repositorio. Recorre todos los archivos salvo las carpetas de dependencias incluidas y generadas (node_modules, vendor, dist, build, .venv y similares), los repositorios anidados y los archivos que ignora .gitignore, y lee .git/index directamente, sin ejecutar git, para saber qué rutas rastrea git y cuánto ocupan. Así detecta dos nombres que solo se diferencian en mayúsculas y minúsculas, o un nombre reservado de Windows, incluso en una copia de trabajo de Windows o macOS donde esos archivos no pueden existir en disco, y así distingue un script que git guarda con CRLF (un problema real) de uno que solo tiene CRLF en esta copia de Windows por core.autocrlf (un problema local). Respeta .gitattributes (text, eol, filter=lfs, conflict-marker-size) y .git/info/exclude. Nunca ejecuta git ni el código del proyecto 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. El contenido de los archivos y los valores secretos nunca se muestran.

Qué comprueba

BLOCK (corregir antes de publicar)

• R01: conflictos de merge que quedaron en los archivos (<<<<<<<, =======, >>>>>>>), sin contar subrayados de encabezados ni ejemplos en bloques de código de Markdown
• R02: archivos de más de 100 MiB que no se guardan con Git LFS
• R03: finales de línea CRLF en scripts de shell, archivos de inicio del shell, archivos #! de sh/bash/node y archivos #! sin extensión (bin/deploy, hooks de git) cuando git los guarda así, .gitattributes define eol=crlf o no hay .git/index con el que comparar
• R04: rutas que solo se diferencian en mayúsculas y minúsculas o en la normalización Unicode, o un archivo con el mismo nombre que una carpeta pero con otras mayúsculas (el hallazgo indica que un proyecto que nunca se clona en Windows ni macOS puede mantenerlas)
• R05: nombres que Windows no puede crear: CON, PRN, AUX, NUL, COM1-9, LPT1-9 (también aux.js, nul.txt), < > : " | ? * \ y caracteres de control, y nombres que terminan en espacio o en punto
• R06: archivos de credenciales que git rastrea: claves privadas SSH, .ppk, .p12, .pfx, .jks, .keystore, .kdbx, AuthKey_*.p8, claves privadas PEM, claves JSON de cuentas de servicio, .git-credentials, .netrc, terraform.tfstate, y archivos env con valores secretos que se llaman .local o que .gitignore ignora (en carpetas de pruebas, ver R22)

REVIEW (revisar antes del lanzamiento)

• R11: archivos de más de 50 MiB que no se guardan con Git LFS
• R12: finales de línea CRLF y LF mezclados sin regla de .gitattributes para el archivo
• R13: una marca de orden de bytes (BOM) UTF-8 en JSON, PHP, scripts de shell y archivos #!
• R14: rutas de más de 200 caracteres desde la raíz del repositorio, o nombres de más de 255 bytes
• R15: enlaces simbólicos que apuntan fuera del repositorio
• R16: archivos .sh sin línea #! en la línea 1
• R17: restos .orig, .rej y _BASE_/_LOCAL_/_REMOTE_/_BACKUP_ de herramientas de merge
• R18: dumps de bases de datos y bases de datos locales que git rastrea (.sql.gz, .dump, dump.sql, dump.rdb, .bson, .sqlite3, .mdf)
• R19: archivos que git rastrea aunque .gitignore o .git/info/exclude los ignore (un hallazgo por cada carpeta ignorada)
• R20: un archivo LICENSE pero ningún SECURITY.md en la raíz, en docs/ ni en .github/
• R21: scripts de shell con CRLF solo en esta copia de trabajo: git los guarda con LF (core.autocrlf=true en Windows), así que el push y la CI en Linux funcionan, pero los builds de WSL y Docker desde la carpeta no
• R22: claves de prueba y almacenes de claves en carpetas test, spec y fixtures, y almacenes de confianza (truststore.jks, cacerts): confirma que no se usan en ningún entorno real

Qué incluye

• El escáner (Python 3.9+, solo biblioteca estándar), con un lector del formato de índice de git (versiones 2, 3 y 4, repositorios SHA-1 y SHA-256, índices divididos, worktrees enlazados)
• Una guía de reglas con el motivo, el enfoque más seguro y la fuente oficial de cada regla
• Un proyecto de ejemplo arriesgado y uno seguro, y el informe real que genera el escáner sobre el arriesgado (el ejemplo muestra seis de las reglas; las demás necesitan cosas que un ZIP no puede contener, como un archivo de 100 MiB, un enlace simbólico o una carpeta .git)

Limitaciones

Lee los archivos tal como están ahora y la lista de rutas rastreadas en .git/index. No se leen el historial de git, otras ramas ni los objetos almacenados, así que no se detecta un archivo eliminado en un commit posterior pero que sigue en el historial. Sin una carpeta .git (un archivo de código fuente descargado) no se ejecutan las reglas sobre archivos rastreados (R06, R18, R19, R22), y un script con CRLF se reporta como R03 porque no se puede comparar con la copia del commit. No se comprueban un archivo de exclusiones global, los atributos globales ni los modos de archivo como el bit de ejecución. No busca secretos en el texto de los archivos. NOT FLAGGED no es una garantía.

Contenido

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

Cómo usarla: Esta es una skill para agentes: una carpeta con un archivo SKILL.md y scripts de Python que un agente de programación con IA como Claude Code, Cursor o Codex CLI puede ejecutar. 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 instalar nada. Solo leen tus archivos: sin acceso a la red, y no se envía nada a ningún sitio.