Skip to content
commit logo

Commit

commit

Create atomic git commits following the three-pass methodology.

SKILL.md

Full skill instructions

commit

Trigger

/​commit

Process

Read ./​atomic-git-commits.md in this skill's directory for the full reference. Then follow these steps.

1. Content pass

  • Run pre-commit run --all-files to fix formatting first
  • Check git status and git diff --staged to understand what's staged
  • Identify how many distinct logical/​atomic changes exist
  • Summarize them: one sentence per proposed commit

2. Get user confirmation

Ask the user which change(s) to proceed with. Even if there is only ONE logical change, get explicit confirmation before proceeding.

3. Standards check

For each commit:

  • Standard prefix used (feat:, fix:, docs:, refactor:, style:, test:, build:, ci:, perf:)
  • Subject capitalized after colon
  • Imperative mood ("Add" not "Added")
  • Under 50 characters for subject
  • Body explains WHY not just what
  • 72 character wrap for body lines

4. Final review

  • Re-read the commit message. Does it tell a complete story?
  • Check the diff one more time. Are all changes intentional?
  • Can this be reverted independently?

5. Commit

Use git commit -e -m "your message" so the message is pre-filled but the user can edit it in their editor before finalizing.

NEVER add a co-author credit.

6. Output

Display the full commit message:

git log -1 --format="%h %s%n%n%b"