name: commit description: Create atomic git commits following the three-pass methodology.
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-filesto fix formatting first - Check
git statusandgit diff --stagedto 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"