| name | git-commit |
| description | Create conventional commits from staged/unstaged changes. Use when user asks to commit, create commits, commit changes, commit all, make commits, separate commits, commit everything, stage and commit, commit these changes, save and push, commit this work, or requests push after committing. Handles single or multiple commits, staging, message generation from diffs, and push operations. |
| allowed-tools | Bash(git add:*), Bash(git status:*), Bash(git commit:*), Bash(git diff:*), Bash(git log:*), Bash(git branch:*), Bash(git push:*) |
Git Commit
Stage changes and create conventional commits from diff analysis.
Workflow
1. Gather Context
git status
git diff HEAD
git log --oneline -10
2. Determine Commit Strategy
Single commit: All changes relate to one logical change Multiple commits: Changes span distinct features/fixes/areas
If multiple commits needed:
- Group related changes by type and scope
- Create separate commits for each group
- Follow dependency order (e.g., deps before features)
3. Per Commit: Analyze & Stage
Review diff to extract:
- Type: feat, fix, refactor, docs, test, chore
- Scope: module/component affected
- Description: imperative mood summary (50-72 chars)
Stage related files:
git add <files-for-this-commit>
Never stage:
.envfiles- Credentials
- Secrets/tokens
4. Create Commit
Format:
<type>(scope): description
Optional body with details
Rules:
- Imperative mood: "add" not "added"
- Generate from diff, not user's words
- NEVER add Claude signature/co-authorship
- Atomic: one logical change per commit
5. Repeat or Push
Multiple commits: Return to step 3 for next commit
Push requested: Run git push after all commits
No push requested: Stop after committing
Conventional Commit Types
feat- New featuresfix- Bug fixesrefactor- Code restructuring without behavior changedocs- Documentation onlytest- Testschore- Tooling, deps, config
Examples
Single commit:
feat(api): add user authentication endpoint
Implements JWT token generation, login/logout routes,
and bcrypt password hashing.
Multiple commits scenario:
1. chore(deps): install jsonwebtoken and bcrypt
2. feat(auth): add JWT token signing function
3. feat(auth): add token verification middleware
4. docs(api): document authentication endpoints