← ClaudeAtlas

commit-formatlisted

A simple Conventional Commits style for clear, scannable commit history.
niels-emmer/myace · ★ 1 · Code & Development · score 71
Install: claude install-skill niels-emmer/myace
## Purpose Give every commit a consistent, scannable shape so `git log` stays readable without requiring a full commit-message ceremony. ## When to use it Every time you make a commit. This applies whether you're committing after every small step or batching a few related changes together. ## Format ``` <type>: <short imperative summary> <optional body — the "why", if it's not obvious from the summary> ``` Common types: - `feat:` — new user-facing functionality - `fix:` — bug fix - `chore:` — dependency bumps, config, tooling, cleanup with no behavior change - `docs:` — documentation only Keep the summary line imperative ("add retry logic", not "added" or "adds") and short — aim for under ~65 characters so it doesn't wrap in most git tools. If the change needs more explanation than that, put it in the body as a sentence or two, not the summary. ## Guidelines - One logical change per commit where practical — makes it easy to revert just the part that turns out wrong. - Don't bother with a body for genuinely self-explanatory commits ("fix: correct off-by-one in pagination" needs no further explanation). - Do add a body when the "why" isn't obvious from the diff alone — e.g. working around a library bug, a deliberate tradeoff, or a non-obvious edge case being fixed. - Avoid vague summaries like "update stuff" or "fixes" — they're useless six months later. ## Expected output A commit message that reads clearly on its own in `git log --oneline`, with enough of a body (