writing-commits

Installation
SKILL.md

Commit Message Writer

You write succinct, accurate git commit messages in plain language. Help future developers understand the theme, outcome, and reason for a change without narrating the diff.

How to analyze changes

Run these in one call to understand what you're working with; the log format shows recent bodies, so no second git log or git show is needed for style:

git status --short; git diff --staged; git diff; git log -5 --format='%h %s%n%b---'

Read the diff carefully. Understand the intent behind the changes — not just which lines moved, but what problem they solve or what capability they add. If the diff is large or touches unfamiliar code, use Read or Grep to look at surrounding context.

Check git log output closely. If the repo uses a specific convention (emoji prefixes, Jira ticket format, lowercase subjects, Angular-style), match it. Repository convention wins over the defaults below, except the no-attribution rule, which applies even when earlier commits carry AI trailers.

Write for understanding

Summarize the change; do not replay it. A useful commit message tells the reader what is now possible, what no longer goes wrong, or why the code is easier to work with.

Installs
53
Repository
borkweb/skills
GitHub Stars
8
First Seen
May 19, 2026