Communitygithub.com

bilals2008/bilal-skills

Colección de habilidades para agentes de IA enfocada en desarrollo web y aplicaciones: TypeScript, React, shadcn/ui, convenciones de commits.

¿Qué es bilal-skills?

Esta skill proporciona un conjunto completo de directrices para prevenir la filtración de información sensible en repositorios de Git. Escanea archivos rastreados en busca de secretos, claves, archivos de compilación y otros elementos que nunca deberían subirse a GitHub. Incluye pasos automatizados para detectar patrones de alto riesgo, actualizar el archivo .gitignore y eliminar archivos sensibles del control de versiones, todo mientras ofrece un informe claro de las acciones tomadas. Está diseñada para desarrolladores que trabajan con TypeScript, React, shadcn/ui y desean seguir buenas prácticas de seguridad y convenciones de commits en sus proyectos web modernos.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add bilals2008/bilal-skills

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Prevención de Filtraciones en Git

Propósito

Evitar que archivos sensibles, secretos y artefactos de compilación se suban a GitHub. Escanea, detecta y corrige automáticamente el .gitignore.

Instrucciones

Paso 1 — Escanear archivos sensibles

Ejecuta este comando para encontrar archivos que NO deberían estar en GitHub:

git ls-files | findstr /i ".env .env.local .env.production .env.staging node_modules dist build releases *.key *.pem *.p12 secrets"

En PowerShell:

git ls-files | Select-String -Pattern "\.env|node_modules|dist|build|releases|\.key$|\.pem$|\.p12$|secrets|\.log$|\.cache$"

También verifica archivos sensibles no rastreados:

git status --porcelain

Paso 2 — Verificar patrones sensibles comunes

Busca estos patrones en archivos rastreados:

PatrónRiesgoAcción
.env / .env.*Claves API, contraseñas de BDEliminar de git + agregar a .gitignore
node_modules/Dependencias (enormes, no necesarias)Eliminar + .gitignore
dist/ / build/Salida compiladaEliminar + .gitignore
releases/Versiones binariasEliminar + .gitignore
*.key / *.pemClaves privadasEliminar + .gitignore
*.p12 / *.pfxCertificadosEliminar + .gitignore
.DS_StoreMetadatos macOS.gitignore
Thumbs.dbMetadatos Windows.gitignore
*.logArchivos de registro.gitignore
.cache/Carpetas de caché.gitignore
coverage/Cobertura de pruebas.gitignore
.turbo/ / .next/Cachés de compilación.gitignore
*.sqlVolcados de base de datos (a veces secretos)Revisar contenido

Paso 3 — Buscar secretos en código

Busca secretos escritos directamente en archivos rastreados:

rg -i "(api[_-]?key|secret|password|token|private[_-]?key)\s*[:=]\s*['\"x22]" --type-add 'code:*.{ts,tsx,js,jsx,json,yaml,yml,env,config}' -t code

Busca patrones como:

  • API_KEY=sk-...
  • SECRET=...
  • PASSWORD=...
  • PRIVATE_KEY-----BEGIN
  • token: "eyJ..."

Paso 4 — Corregir .gitignore automáticamente

Si se encuentran archivos sensibles, actualiza el .gitignore automáticamente:

# Revisar .gitignore actual
cat .gitignore

Agregar entradas faltantes. .gitignore estándar para proyectos web:

# Archivos de entorno
.env
.env.local
.env.production
.env.staging
.env.development

# Dependencias
node_modules/

# Salida de compilación
dist/
build/
release/
releases/

# Secretos
*.key
*.pem
*.p12
*.pfx

# IDE
.vscode/settings.json
.idea/

# Sistema operativo
.DS_Store
Thumbs.db

# Registros
*.log
npm-debug.log*

# Caché
.cache/
.turbo/
.next/
.nuxt/

# Cobertura
coverage/

# Miscelánea
*.swp
*.swo

Paso 5 — Eliminar archivos sensibles del control de versiones (si ya estaban rastreados)

Si hay archivos sensibles ya rastreados:

# Eliminar del seguimiento pero mantener localmente
git rm --cached .env
git rm --cached -r node_modules/
git rm --cached -r dist/
git rm --cached -r build/

# Luego agregar a .gitignore

ADVERTENCIA: Si los secretos ya se subieron a GitHub, están comprometidos. El usuario debe:

  1. Rotar todas las claves/secretos expuestos inmediatamente
  2. Nunca volver a usar los mismos secretos

Paso 6 — Mostrar informe al usuario

Presenta los hallazgos de manera clara:

🔍 Informe de Escaneo de Seguridad

Archivos en riesgo:
  ❌ .env — rastreado (contiene secretos)
  ❌ node_modules/ — rastreado (debería ignorarse)
  ⚠️ dist/ — rastreado (salida de compilación)

Acciones realizadas:
  ✅ Agregado .env a .gitignore
  ✅ Agregado node_modules/ a .gitignore
  ✅ Agregado dist/ a .gitignore
  ✅ Eliminado .env del seguimiento de git (mantenido localmente)

⚠️ Si .env contenía secretos reales, RÓTALOS ahora.
   El historial de GitHub aún tiene la versión antigua.

Paso 7 — Hacer commit de la corrección

git add .gitignore
git commit -m "chore(security): actualizar gitignore para prevenir filtraciones de secretos"

Qué NO hacer

  • ❌ Nunca mostrar valores reales de secretos en el informe (enmascararlos: sk-****...****)
  • ❌ Nunca hacer commit de .env o secretos, ni siquiera por razones "temporales"
  • ❌ Nunca ignorar la advertencia si los secretos ya se subieron
  • ❌ Nunca omitir verificar git ls-files — los archivos no rastreados están bien, los rastreados son el riesgo

Salida esperada

Un informe de seguridad limpio que muestre:

  1. Qué se encontró en riesgo
  2. Qué se corrigió automáticamente
  3. Qué debe hacer el usuario manualmente (rotar claves)

Skills relacionados