AI Skills
conventional-commit

conventional-commit

Generates git commit messages following Conventional Commits 1.0.0 specification with semantic types (feat, fix, etc.), optional scope, and breaking change annotations. Use when committing code changes or creating commit messages.

3étoiles
0forks
Mis à jour 1/21/2026
ObtenirCode Source
SKILL.md
readonlyread-only
name
conventional-commit
description

Generates git commit messages following Conventional Commits 1.0.0 specification with semantic types (feat, fix, etc.), optional scope, and breaking change annotations. Use when committing code changes or creating commit messages.

Conventional Commit Generator

Generate commit messages following Conventional Commits 1.0.0.

Workflow

  1. Run git status and git diff HEAD to analyze changes

  2. Stage files: user-specified only, or git add -A for all

  3. Determine type and scope from changes

  4. Generate commit message incorporating user hints

  5. Commit using HEREDOC format to preserve formatting:

    git commit -m "$(cat <<'EOF'
<type>(<scope>): <description>

<body>

<footer>
EOF
)"

  6. Output: <hash> <subject>

Scope Boundaries

DO: Analyze git changes, generate messages, stage files, commit

DO NOT: Modify code, push (unless asked), create branches, amend without request

Commit Format

<type>[optional scope][!]: <description>

[optional body]

[optional footer(s)]

Type Selection

Change Type SemVer
New feature feat MINOR
Bug fix fix PATCH
Performance improvement perf PATCH
Code restructuring (no behavior change) refactor -
Code style/formatting (no logic change) style -
Adding/updating tests test -
Documentation only docs -
Build system/dependencies build -
CI/CD configuration ci -
Reverts a previous commit revert -
Other maintenance tasks chore -

Note: Only feat and fix have SemVer implications. Breaking changes (any type with exclamation mark or BREAKING CHANGE footer) trigger MAJOR.

Subject Line

  • Max length: 72 characters (50 recommended for readability)
  • Format: type(scope): description or type: description
  • Mood: Imperative present tense ("add" not "added" or "adds")
  • Case: Lowercase first letter
  • Punctuation: No trailing period

Scope

Scope provides context about which part of the codebase is affected. Use a noun describing the module, component, or area.

Common scope patterns:

  • Component/module: feat(auth):, fix(parser):, refactor(api):
  • File/area: docs(readme):, test(unit):, build(webpack):
  • Feature: feat(dark-mode):, fix(checkout):

Body

  • Separate from subject with one blank line
  • Explain what and why, not how
  • Can contain multiple paragraphs (separate with blank lines)
  • Wrap at 72 characters

Footer

Footers follow git trailer format with :<space> or <space># separator.

Common footers:

  • BREAKING CHANGE: <description> - Breaking API change
  • Refs: #123 or Refs: JIRA-456 - Reference issues
  • Closes: #123 or Fixes: #123 - Close issues
  • Co-authored-by: Name <email> - Credit co-authors
  • Reviewed-by: Name <email> - Credit reviewers
  • Acked-by: Name - Acknowledgment

Note: Footer tokens use - instead of spaces (e.g., Reviewed-by not Reviewed by). Exception: BREAKING CHANGE allows space.

Breaking Changes

Two ways to indicate breaking changes (can use both for emphasis):

  1. Exclamation mark: Add exclamation mark before colon in subject

    feat(api)!: remove deprecated endpoints

  2. Footer: Add BREAKING CHANGE: or BREAKING-CHANGE: in footer

    feat(api): redesign authentication flow

BREAKING CHANGE: OAuth tokens now expire after 1 hour instead of 24 hours.

Examples

Simple feature:

feat: add email notifications for new messages

Bug fix with scope:

fix(cart): prevent ordering with empty shopping cart

Documentation update:

docs(api): add authentication examples to README

Breaking change with body and footer:

feat(api)!: redesign user authentication endpoints

Migrate from session-based auth to JWT tokens for better scalability.
The new system supports refresh tokens and configurable expiration.

BREAKING CHANGE: /api/login now returns JWT instead of session cookie.
Clients must include Authorization header with Bearer token.
Refs: JIRA-1337

Revert commit:

revert: let us never again speak of the noodle incident

Refs: 676104e, a215868

Multi-scope change (use most significant):

feat(auth): add OAuth2 support with Google provider

Adds Google OAuth2 login flow with automatic account linking.

Co-authored-by: Jane Doe <jane@example.com>
Closes: #42

Anti-patterns

Avoid these common mistakes:

Bad Good Reason
Update code fix(auth): validate token expiration Be specific
Fixed bug fix: prevent null pointer in parser Use present tense
WIP Don't commit WIP Commit complete units
Add feature. feat: add dark mode toggle No trailing period
Added tests test: add unit tests for parser Use imperative mood
FEAT: Add... feat: add... Types are lowercase
misc changes chore: update dependencies Be descriptive

You Might Also Like

Related Skills

internal-comms

internal-comms

47Kwriting

A set of resources to help me write all kinds of internal communications, using the formats that my company likes to use. Claude should use this skill whenever asked to write some sort of internal communications (status reports, leadership updates, 3P updates, company newsletters, FAQs, incident reports, project updates, etc.).

anthropics avataranthropics
Obtenir
write-pr

write-pr

45Kwriting

Writing pull request titles and descriptions for the tldraw repository. Use when creating a new PR, updating an existing PR's title or body, or when the /pr command needs PR content guidance.

tldraw avatartldraw
Obtenir
data-storytelling

data-storytelling

26Kwriting

Transform data into compelling narratives using visualization, context, and persuasive structure. Use when presenting analytics to stakeholders, creating data reports, or building executive presentations.

wshobson avatarwshobson
Obtenir
employment-contract-templates

employment-contract-templates

26Kwriting

Create employment contracts, offer letters, and HR policy documents following legal best practices. Use when drafting employment agreements, creating HR policies, or standardizing employment documentation.

wshobson avatarwshobson
Obtenir
tailored-resume-generator

tailored-resume-generator

23Kwriting

Analyzes job descriptions and generates tailored resumes that highlight relevant experience, skills, and achievements to maximize interview chances

ComposioHQ avatarComposioHQ
Obtenir
content-research-writer

content-research-writer

23Kwriting

Assists in writing high-quality content by conducting research, adding citations, improving hooks, iterating on outlines, and providing real-time feedback on each section. Transforms your writing process from solo effort to collaborative partnership.

ComposioHQ avatarComposioHQ
Obtenir