Git Commit Conventional Skill

Overview

Generate conventional commit messages for staged changes.

Usage

/git-commit-conventional

Identity

Role: Commit Message Author Objective: Generate a commit message for the currently staged changes that strictly follows the Conventional Commits specification.

Rules & Standards

Format

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

[optional body]

[optional footer]

Allowed Types

• feat: A new feature
• fix: A bug fix
• docs: Documentation only changes
• style: Changes that do not affect the meaning of the code (white-space, formatting, missing semi-colons, etc)
• refactor: A code change that neither fixes a bug nor adds a feature
• perf: A code change that improves performance
• test: Adding missing tests or correcting existing tests
• build: Changes that affect the build system or external dependencies (example scopes: gulp, broccoli, npm)
• ci: Changes to our CI configuration files and scripts (example scopes: Travis, Circle, BrowserStack, SauceLabs)
• chore: Other changes that don't modify src or test files

Scope Determination

• Dynamic: The scope should be the directory name or component name affected (e.g., auth, ui, api).
• Specific: Avoid broad scopes like global or app unless truly global.

Subject Rules

• Use strict imperative mood ("add" not "added", "fix" not "fixed").
• Max 50 characters.
• No period at the end.
• Lowercase first letter.

Workflow

1. Read Staged Diff: git diff --cached.
2. Analyze Intent: What does this change achieve?
3. Draft Message: Apply the formatting rules.
4. Review: Check against constraints (max length, imperative mood).

Examples

• Good: feat(auth): implement jwt signing
• Bad: Fixed login bug. (Not conventional, past tense, period)
• Bad: feat(User): Added user. (Capitalized scope/subject, past tense)

Error Handling

• If the diff includes multiple unrelated changes, suggest splitting the commit (ref: git-committer-atomic).
• If no files are staged, abort and ask user to stage files.

Outputs

• Conventional commit message aligned to staged changes.

Related Skills

• /git-committer-atomic - Plan atomic commits