conventional-git

Standardize Git commit messages and branch naming using Conventional Commits v1.0.0 rules.

178|15|Updated Mar 21, 2026
One-click install
npx skills add https://github.com/samber/cc-skills --skill conventional-git-samber
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: conventional-git
Source: https://github.com/samber/cc-skills/tree/main/skills/conventional-git
Command: npx skills add https://github.com/samber/cc-skills --skill conventional-git-samber

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Conventional commits standardize branch naming, worktree usage, and commit messages to create a clean, machine-readable history that simplifies changelogs, reviews, and automation across GitHub and GitLab projects.

Core Features & Use Cases

  • Enforces branch naming patterns: type/description, issue numbers, and lowercase-hyphen formatting to keep history navigable.
  • Guides worktree naming and management to avoid local checkout leaks into remote history.
  • Standardizes commit messages with the format type(scope): subject and rules for body, footers, and breaking changes.
  • Enables automated changelogs and accurate issue closing through conventional-commit metadata.

Quick Start

Use the conventional commit format for your next change, for example: feat(auth): add user login

Frequently Asked Questions about conventional-git

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I standardize Git commit messages for automated changelog generation?

Standardize Git commit messages using Conventional Commits v1.0.0 rules with the format type(scope): subject. This creates a clean, machine-readable history that enables automated changelog generation and accurate issue closing across GitHub and GitLab projects.

What is the conventional commit format for breaking changes and footers?

The conventional commit format uses type(scope): subject for the header, with specific rules for formatting the body, footers, and breaking changes. This structured format ensures reliable parsing by automation tooling for changelogs and issue tracking.

How do I name Git branches and worktrees to keep history navigable?

Name Git branches and worktrees using type/description patterns with issue numbers and lowercase-hyphen formatting. This standardization prevents local checkout leaks into remote history and keeps your repository history navigable.

Does conventional commit standardization work with both GitHub and GitLab?

Yes, conventional commit standardization applies to both GitHub and GitLab projects. It enforces branch naming, worktree management, and commit message conventions to produce clean, parseable history across both platforms.

Why do my automated changelogs fail to parse Git history correctly?

Automated changelogs fail to parse Git history when commit messages lack conventional commit metadata. Enforcing subject length limits, body formatting, breaking change notation, and footers ensures tooling can reliably parse your history.

What are the limitations of using conventional commits for branch naming?

Conventional commits require strict adherence to type/description patterns, issue numbers, and lowercase-hyphen formatting for branch naming. Deviating from these rules breaks automated parsing and prevents reliable changelog generation.