commits-real
Commits, PRs e issues con voz humana — español rioplatense cálido. Límite 300 líneas. Modo técnico (inglés) también disponible. Trigger: When writing commits, creating PRs, filing issues, or writing d
SKILL.mdskills/commits-real/SKILL.md
GitHubSkill: commits-real
Commits que cuentan una historia, no que parecen generados por una máquina.
Trigger
- Terminaste un cambio y hay que comitear
- Estás creando un PR o issue
- Necesitás actualizar un CHANGELOG
- Vas a versionar semver
Modos de commit
Modo Humano (default — español rioplatense)
Cálido, claro, directo. Como si se lo explicaras a un colega.
feat(api): agrego endpoint de login pa que los users entren tranqui
Ahora se puede autenticar con email + password. Devuelve un JWT
con expiración de 24hs. Implementé middleware de verificación
también, así que ya estamos cubiertos del lado del server.
Closes #42
fix(data): corrijo el cálculo de interés compuesto
El error estaba en la línea 47 — estaba usando la tasa nominal
cuando tenía que ser la tasa efectiva mensual. Afectaba todos
los préstamos con periodo > 30 días.
feat(ui): agrego dark mode que tanto venías pidiendo
Toggle en el header, usa CSS variables, persiste en localStorage.
Anda en todos los browsers que importan.
Modo Técnico (inglés — para proyectos open source / internacional)
Conventional Commits clásico en inglés US.
feat(api): add JWT authentication endpoint
Implements email+password login returning a signed JWT.
Token expires in 24h. Includes middleware for route protection.
Closes #42
Reglas de oro
- Máximo 300 líneas por commit/PR/issue — si supera, usá
chained-pr - Atomic commits — un cambio lógico por commit
- Contá una historia — el título dice QUÉ, el body dice POR QUÉ y el PATRÓN
- Nunca hagas commit sin testear antes — primero delegá a
lend-ai-testing - Engram siempre — guardá lo que se hizo con mem_save
Workflow LEND
ANALIZAR ├── ¿Qué cambió? archivos, funcionalidad, bug, refactor? ├── Scope: ¿qué módulo? (api, ui, data, infra, docs) ├── Breaking: ¿rompe compatibilidad hacia atrás? └── Issues: ¿hay issues o PRs relacionados?
OFRECER (Menú del Senior) ├── A) Modo humano — español rioplatense, título + breve descripción ├── B) Modo técnico — conventional commit en inglés ├── C) Full — commit + PR + changelog update └── D) Chained PR — si supera 300 líneas, partilo en PRs encadenados
ELEGIR → user confirma
HACER (PRE-COMMIT GATES primero!) ├── ¿Ya corriste tests? Si no →
task('lend-ai-testing', 'verificar que todo anda')├── ¿Está todo en verde? Ok seguí ├── ¿Supera 300 líneas? →task('chained-pr', ...), no commits gigantes ├── Formato humano:tipo(scope): título en español cálido├── Tipos: feat, fix, chore, docs, refactor, test, style, perf, ci ├── Mensaje: imperativo, presente, < 60 chars título, < 80 chars body ├── Atomic: un cambio por commit └── Issues:Closes #123en el bodyVERIFICAR ├── El mensaje es claro y útil para el futuro ├── No hay archivos no relacionados ├── Breaking changes están documentados └── Tests pasan (siempre)
Post-task (siempre)
- mem_save a Engram con lo que se hizo
- Revisar si hay que actualizar docs (README, AGENTS.md, ARCHITECTURE.md)
Regla del título (modo humano)
tipo(scope): qué hace, en menos de 60 caracteres, en español
Tipos: feat (nueva funcionalidad), fix (bug fix), refactor, test,
docs, style, chore, perf, ci
Scope: api, ui, data, infra, docs, deps, config
Ejemplos:
feat(api): agrego ruta de login con JWT
fix(data): corrijo cálculo de interés compuesto
refactor(ui): extraigo Navbar a componente separado
test(api): agrego tests para auth middleware
docs(readme): actualizo ejemplos de uso
chore(deps): actualizo pandas a 2.0
Comment/Voice rules (PRs, issues, reviews)
- Cálido y directo: "Che, esto está mal porque..." no "Se sugiere reconsiderar..."
- Corto: 1-2 oraciones. Expandí solo si hace falta.
- Explicá el por qué: cada observación incluye la razón
- Idioma: español rioplatense con voseo
- Sé útil rápido: arrancá con lo que importa
Comment formula
Observación directa → Por qué importa → Acción concreta
"Este hook necesita useCallback. Sin memoization se recrea en cada
render y rompe las dependencias del useEffect de abajo.
Metele useCallback con [] y tiramos."
PR guidelines
- Qué revisar PRIMERO (archivos de alto impacto)
- Qué está FUERA DE SCOPE (no hagas adivinar al reviewer)
- Link de contexto si es parte de una cadena de PRs
- Test plan: qué se testeó manual y automáticamente
Anti-patterns
- ❌ Mensajes vagos: "update", "fix", "cambios"
- ❌ Múltiples features en un solo commit
- ❌ Breaking changes sin nota
- ❌ Archivos no relacionados en el mismo commit
- ❌ Commits sin test previo
- ❌ Superar 300 líneas sin partir en chained-pr