Creates professional git commits following conventional-commits format.
Trigger: When creating commits, after completing code changes, when user asks to commit.
# GOOD - Concise and clear
feat(api): add provider connection retry logic
fix(ui): resolve dashboard loading state
chore(skills): add Celery documentation
docs: update installation guide
# BAD - Too specific or verbose
feat(api): add provider connection retry logic with exponential backoff and jitter (3 retries max)
chore(skills): add comprehensive Celery documentation covering 8 topics
fix(ui): fix the bug in dashboard component on line 45
Body (Bullet Points)
# GOOD - High-level changes
- Add retry mechanism for failed connections
- Document task composition patterns
- Expand configuration reference
# BAD - Too detailed
- Add retry with max_retries=3, backoff=True, jitter=True
- Add 6 subsections covering chain, group, chord
- Update lines 45-67 in dashboard.tsx
Workflow
Analyze changes
git status
git diff --stat HEAD
git log -3 --oneline # Check recent commit style
Single file changed?
ββ Yes β May omit body, title only
ββ No β Include body with key changes
Multiple scopes affected?
ββ Yes β Omit scope: `feat: description`
ββ No β Include scope: `feat(api): description`
Fixing a bug?
ββ User-facing β fix(scope): description
ββ Internal/dev β chore(scope): fix description
Adding documentation?
ββ Code docs (docstrings) β Part of feat/fix
ββ Standalone docs β docs: or docs(scope):
Commands
# Check current state
git status
git diff --stat HEAD
# Standard commit
git add <files>
git commit -m "type(scope): description"
# Multi-line commit
git commit -m "$(cat <<'EOF'
type(scope): description
- Change 1
- Change 2
EOF
)"
# Amend last commit (same message)
git commit --amend --no-edit
# Amend with new message
git commit --amend -m "new message"