Skill: 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 #123 en el body
VERIFICAR
├── 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
1---2name: commits-real3description: >4 Commits, PRs e issues con voz humana — español rioplatense cálido.5 Límite 300 líneas. Modo técnico (inglés) también disponible.6 Trigger: When writing commits, creating PRs, filing issues, or writing documentation.7license: MIT8metadata:9 source: https://skillmd.com/skills/leandrobenjaminl/commits-real10 author: Leandro Benjamin L.11 version: "4.0"12 model_tier: T3-balanced13---1415# Skill: commits-real1617Commits que cuentan una historia, no que parecen generados por una máquina.1819## Trigger2021- Terminaste un cambio y hay que comitear22- Estás creando un PR o issue23- Necesitás actualizar un CHANGELOG24- Vas a versionar semver2526## Modos de commit2728### Modo Humano (default — español rioplatense)29Cálido, claro, directo. Como si se lo explicaras a un colega.3031```32feat(api): agrego endpoint de login pa que los users entren tranqui3334Ahora se puede autenticar con email + password. Devuelve un JWT35con expiración de 24hs. Implementé middleware de verificación36también, así que ya estamos cubiertos del lado del server.3738Closes #4239```4041```42fix(data): corrijo el cálculo de interés compuesto4344El error estaba en la línea 47 — estaba usando la tasa nominal45cuando tenía que ser la tasa efectiva mensual. Afectaba todos46los préstamos con periodo > 30 días.47```4849```50feat(ui): agrego dark mode que tanto venías pidiendo5152Toggle en el header, usa CSS variables, persiste en localStorage.53Anda en todos los browsers que importan.54```5556### Modo Técnico (inglés — para proyectos open source / internacional)57Conventional Commits clásico en inglés US.5859```60feat(api): add JWT authentication endpoint6162Implements email+password login returning a signed JWT.63Token expires in 24h. Includes middleware for route protection.6465Closes #4266```6768## Reglas de oro69701. **Máximo 300 líneas por commit/PR/issue** — si supera, usá `chained-pr`712. **Atomic commits** — un cambio lógico por commit723. **Contá una historia** — el título dice QUÉ, el body dice POR QUÉ y el PATRÓN734. **Nunca hagas commit sin testear antes** — primero delegá a `lend-ai-testing`745. **Engram siempre** — guardá lo que se hizo con mem_save7576## Workflow LEND77781. ANALIZAR79 ├── ¿Qué cambió? archivos, funcionalidad, bug, refactor?80 ├── Scope: ¿qué módulo? (api, ui, data, infra, docs)81 ├── Breaking: ¿rompe compatibilidad hacia atrás?82 └── Issues: ¿hay issues o PRs relacionados?83842. OFRECER (Menú del Senior)85 ├── A) Modo humano — español rioplatense, título + breve descripción86 ├── B) Modo técnico — conventional commit en inglés87 ├── C) Full — commit + PR + changelog update88 └── D) Chained PR — si supera 300 líneas, partilo en PRs encadenados89903. ELEGIR → user confirma91924. HACER (PRE-COMMIT GATES primero!)93 ├── ¿Ya corriste tests? Si no → `task('lend-ai-testing', 'verificar que todo anda')`94 ├── ¿Está todo en verde? Ok seguí95 ├── ¿Supera 300 líneas? → `task('chained-pr', ...)`, no commits gigantes96 ├── Formato humano: `tipo(scope): título en español cálido`97 ├── Tipos: feat, fix, chore, docs, refactor, test, style, perf, ci98 ├── Mensaje: imperativo, presente, < 60 chars título, < 80 chars body99 ├── Atomic: un cambio por commit100 └── Issues: `Closes #123` en el body1011025. VERIFICAR103 ├── El mensaje es claro y útil para el futuro104 ├── No hay archivos no relacionados105 ├── Breaking changes están documentados106 └── Tests pasan (siempre)107108### Post-task (siempre)1091. mem_save a Engram con lo que se hizo1102. Revisar si hay que actualizar docs (README, AGENTS.md, ARCHITECTURE.md)111112## Regla del título (modo humano)113114```115tipo(scope): qué hace, en menos de 60 caracteres, en español116117Tipos: feat (nueva funcionalidad), fix (bug fix), refactor, test,118 docs, style, chore, perf, ci119Scope: api, ui, data, infra, docs, deps, config120121Ejemplos:122 feat(api): agrego ruta de login con JWT123 fix(data): corrijo cálculo de interés compuesto124 refactor(ui): extraigo Navbar a componente separado125 test(api): agrego tests para auth middleware126 docs(readme): actualizo ejemplos de uso127 chore(deps): actualizo pandas a 2.0128```129130## Comment/Voice rules (PRs, issues, reviews)131132- **Cálido y directo**: "Che, esto está mal porque..." no "Se sugiere reconsiderar..."133- **Corto**: 1-2 oraciones. Expandí solo si hace falta.134- **Explicá el por qué**: cada observación incluye la razón135- **Idioma**: español rioplatense con voseo136- **Sé útil rápido**: arrancá con lo que importa137138## Comment formula139140```141Observación directa → Por qué importa → Acción concreta142143"Este hook necesita useCallback. Sin memoization se recrea en cada144render y rompe las dependencias del useEffect de abajo.145Metele useCallback con [] y tiramos."146```147148## PR guidelines149150- Qué revisar PRIMERO (archivos de alto impacto)151- Qué está FUERA DE SCOPE (no hagas adivinar al reviewer)152- Link de contexto si es parte de una cadena de PRs153- Test plan: qué se testeó manual y automáticamente154155## Anti-patterns156157- ❌ Mensajes vagos: "update", "fix", "cambios"158- ❌ Múltiples features en un solo commit159- ❌ Breaking changes sin nota160- ❌ Archivos no relacionados en el mismo commit161- ❌ Commits sin test previo162- ❌ Superar 300 líneas sin partir en chained-pr