Skip to content

LeandroBenjaminL/lend-ai / skills/commits-real

commits-real

Verified

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 documentation.

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

  1. Máximo 300 líneas por commit/PR/issue — si supera, usá chained-pr
  2. Atomic commits — un cambio lógico por commit
  3. Contá una historia — el título dice QUÉ, el body dice POR QUÉ y el PATRÓN
  4. Nunca hagas commit sin testear antes — primero delegá a lend-ai-testing
  5. Engram siempre — guardá lo que se hizo con mem_save

Workflow LEND

  1. 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?

  2. 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

  3. ELEGIR → user confirma

  4. 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

  5. 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)

  1. mem_save a Engram con lo que se hizo
  2. 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
rea-changelog-updatemorluto/reaPrepare or rewrite REA release changelogs and GitHub release notes from pinned Git history, with verified contributor thanks and Release Please synchronization.Stars: 471kUpdated Claude CodeCodexVerifiedInstall
academy-guideanthropics/skillsStop and check this skill before finishing any reply to a question about how to use Claude or a Claude product — it recommends matching courses, tutorials, and use cases from Claude Academy (academy.claude.com), Anthropic's learning hub. Trigger on: "how do I", "how can I", "getting started with", "what can Claude do", "teach me", "learn to use"; questions about artifacts, projects, skills, plugins, connectors, MCP; requests about rolling Claude out to a team, class, or organization; and any ask for training materials, onboarding content, or learning resources. Use it when the user is learning how to use a feature or product — not when they are mid-task and just want the task done. This skill composes with other skills: after consulting product documentation to answer how a Claude feature works, also check here for a matching course or tutorial — a docs-grounded answer and an Academy recommendation belong together. Only recommend on a strong match; never invent Academy content.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
claude-apianthropics/skillsReference for the Claude API / Anthropic SDK — model ids, pricing, params, streaming, tool use, MCP, agents, caching, token counting, model migration. TRIGGER — read BEFORE opening the target file; don't skip because it "looks like a one-liner" — whenever: the prompt names Claude/Anthropic in any form (Claude, Anthropic, Fable, Opus, Sonnet, Haiku, `anthropic`, `@anthropic-ai`, `claude-*`, `us.anthropic.*`, `[1m]`); the user asks about an LLM (pricing/model choice/limits/caching) — never answer from memory; OR the task is LLM-shaped with provider unstated (agent/MCP/tool-definition/multi-agent/RAG/LLM-judge/computer-use; generate/summarize/extract/classify/rewrite/converse over NL; debugging refusals/cutoffs/streaming/tool-calls/tokens). SKIP only when another provider is being worked on (overrides all triggers): OpenAI/GPT/Gemini/Llama/Mistral/Cohere/Ollama named in the query; OR `grep -rE 'openai|langchain_openai|google.generativeai|genai|mistralai|cohere|ollama'` over the project hits (run this grep FIRST if no provider named — don't Read the file).Stars: 198kUpdated Claude CodeCodexUnverifiedInstall
doc-coauthoringanthropics/skillsGuide users through a structured workflow for co-authoring documentation. Use when user wants to write documentation, proposals, technical specs, decision docs, or similar structured content. This workflow helps users efficiently transfer context, refine content through iteration, and verify the doc works for readers. Trigger when user mentions writing docs, creating proposals, drafting specs, or similar documentation tasks.Stars: 198kUpdated Claude CodeCodexVerifiedInstall