name: git-commit
description: Guide for Git commit messages and pushing code. Use when user says "commit", "push code", "push to git", "save changes to git", "git add and commit", "commit and push", or needs help writing commit messages following Conventional Commits.

Git Commit Messages

This skill provides guidance for writing clear, consistent commit messages following the Conventional Commits specification.

When to Use This Skill

Use this skill when user requests any of these (in any language):
- "commit", "push code", "push to git", "commit và push"
- "save changes to git", "lưu code lên git"
- "git add and commit", "commit changes"
- Writing commit messages for any code changes
- Ensuring commit history is clean and readable
- Following team/project commit conventions
- Generating changelogs automatically
- Ensuring documentation is up-to-date with code changes

Pre-commit Checklist

Before committing, ask yourself:

1. Documentation: Does this change affect the public API, installation, or usage?
   • If YES, update README.md or relevant documentation files.
2. Examples: Do any existing examples in the docs need updating?
3. Tests: Have tests been updated or added to cover this change?
4. Changelog: Does this change warrant a manual entry in CHANGELOG.md?

[!TIP]
If a commit requires a documentation update, consider including it in the same commit or a subsequent docs commit. Using a multi-line commit message to cross-reference the doc change is a best practice.

Commit Message Format

(emoji)<type>(<scope>): <subject>

[optional body]

[optional footer(s)]

[!NOTE]
Emoji is required for all commit messages. See the emoji mapping below.

Components

Commit Types

Emoji Prefix Format (Required)

All commit messages must be prefixed with emojis for better visual scanning and commit categorization:

(emoji)<type>(<scope>): <subject>

Format Examples

🐛 fix(api): handle null response
✨ feat(auth): add OAuth login
📚 docs: update installation guide
🔧 refactor(utils): simplify validation logic
🚀 perf(query): optimize database queries

Type to Emoji Mapping

[!IMPORTANT]
Using emojis is required for all commit messages. This ensures consistent commit history and makes it easier to scan and categorize changes in the git log.

Subject Line Rules

1. Must start with emoji: See required emoji mapping below
2. Use imperative mood: "add" not "added" or "adds"
3. No capitalization: start lowercase
4. No period at the end
5. Max 50 characters (hard limit: 72)
6. Be specific: what changed, not why

- feat: Updated the login page
+ ✨ feat(auth): add password reset form

- fix: bug fix
+ 🐛 fix(cart): prevent duplicate items

- added new feature
+ ✨ feat(dashboard): add real-time notifications

Body Guidelines

• Separate from subject with blank line
• Wrap at 72 characters
• Explain what and why, not how
• Use bullet points for multiple changes

✨ feat(auth): add two-factor authentication

- Add TOTP-based 2FA using authenticator apps
- Store encrypted backup codes in database
- Add SMS fallback for 2FA recovery

This improves account security for enterprise users
who require MFA compliance.

Footer Conventions

Breaking Changes

✨ feat(api)!: change response format

BREAKING CHANGE: API now returns data in envelope format.
Clients must update to extract data from `response.data`.

Issue References

🐛 fix(login): handle expired tokens

Closes #123
Fixes #456
Refs #789

Decision Tree

What type of change?
├── Adding new functionality → feat
├── Fixing a bug → fix
├── Updating documentation → docs
├── Formatting/linting only → style
├── Restructuring code → refactor
├── Improving performance → perf
├── Adding/fixing tests → test
├── Build/dependencies → build
├── CI/CD changes → ci
└── Everything else → chore

Examples

Feature

git commit -m "✨ feat(checkout): add Apple Pay support"

Bug Fix

git commit -m "🐛 fix(auth): prevent session timeout on active users"

With Body

git commit -m "🔧 refactor(api): migrate to async/await

Replace callback-based API calls with async/await pattern.
This improves readability and error handling.

Refs #234"

Breaking Change

git commit -m "✨ feat(api)!: change authentication to JWT

BREAKING CHANGE: Session-based auth is no longer supported.
All clients must use Bearer tokens."

Common Mistakes

Tools

Commitlint

Enforce commit conventions:

npm install -D @commitlint/cli @commitlint/config-conventional

// commitlint.config.js
module.exports = {
  extends: ['@commitlint/config-conventional']
};

Commitizen

Interactive commit helper:

npm install -D commitizen cz-conventional-changelog
npx cz

Related Resources

• Conventional Commits
• Angular Commit Guidelines