conventional-commits

Standardize git commit messages using the Conventional Commits format.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/punkfuncgames/tetris-clone --skill conventional-commits-punkfuncgames
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: conventional-commits
Source: https://github.com/punkfuncgames/tetris-clone/tree/main/.claude/skills/conventional-commits
Command: npx skills add https://github.com/punkfuncgames/tetris-clone --skill conventional-commits-punkfuncgames

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Inconsistent or vague git commit messages make code review, changelog generation, and automatic versioning unreliable; this guide provides a strict, machine-friendly format to make history discoverable and meaningful.

Core Features & Use Cases

  • Formalized Commit Format: Defines required type, optional scope, imperative subject, body and footer conventions to create predictable commit entries.
  • Breaking Change & Scope Handling: Explains how to mark breaking changes and choose module scopes to support safe refactors and automated releases.
  • Use Case: Teams preparing release notes and automated semantic version bumps can follow these rules to generate changelogs and integrate with CI/CD tools.

Quick Start

Use the conventional-commits guide to write commit messages like feat(ui): add dark mode toggle when introducing new user-facing features.

Frequently Asked Questions about conventional-commits

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

FAQPage Schema
What is the conventional commits format for git commit messages?▼

The conventional commits format standardizes git commit messages using a required type, optional scope, imperative subject, body, and footer to make commit history machine-parseable for automated tooling.

How do I write a git commit message for automated semantic versioning?▼

To write a git commit message for semantic versioning, structure it with a type like feat or fix, an optional scope, and a descriptive subject, such as feat(ui): add dark mode toggle, to trigger automated version bumps.

How do I mark breaking changes in commit messages for changelog generation?▼

Mark breaking changes in commit messages by adding a footer with a BREAKING CHANGE marker or appending an exclamation mark after the type, ensuring safe refactors and automated releases update the changelog accordingly.

Can I use conventional commits for PR titles in CI-driven release automation?▼

Yes, conventional commits can be applied to PR titles in CI-driven release automation, providing a strict, machine-friendly format that ensures consistent changelog generation and reliable semantic version bumps.

Why does inconsistent git commit history break changelog generation?▼

Inconsistent git commit history breaks changelog generation because vague messages lack the machine-readable type, scope, and breaking-change markers required by automated tools to reliably parse changes and generate release notes.

Do I need commitlint to enforce conventional commit messages?▼

Commitlint is commonly used to enforce conventional commit messages in team repositories, ensuring entries follow the required type, scope, and imperative subject rules for predictable automated releases.