commit-message-guide

Enforce conventional commit syntax with type, scope, and subject.

3|Updated Mar 20, 2026
One-click install
npx skills add https://github.com/alkofu/ai-tpk --skill commit-message-guide-alkofu
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: commit-message-guide
Source: https://github.com/alkofu/ai-tpk/tree/main/claude/skills/commit-message-guide
Command: npx skills add https://github.com/alkofu/ai-tpk --skill commit-message-guide-alkofu

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Commit messages are often terse, inconsistent, and hard to parse during reviews and changelogs, making it difficult to track changes over time. This skill guides teams to write clear, conventional commits that convey intent and scope.

Core Features & Use Cases

  • Enforces conventional commit structure (type(scope): subject) to standardize messages.
  • Provides guidance on subject tense, scope usage, and allowed types (feat, fix, refactor, perf, style, test, docs, build, ci, chore).
  • Supports best practices for including optional body and footer information to capture rationale and breaking changes.

Quick Start

Draft a commit using the conventional format: <type>(<scope>): <subject>.

Frequently Asked Questions about commit-message-guide

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

FAQPage Schema
How do I write conventional commit messages for git?

Conventional commit messages use the syntax <type>(<scope>): <subject> to standardize code changes. This structure defines allowed types like feat or fix, applies optional body and footer information, and conveys clear intent during version control workflows.

What types are allowed in the conventional commits style guide?

Allowed types in the conventional commits style guide include feat, fix, refactor, perf, style, test, docs, build, ci, and chore. These types standardize the required syntax and help teams track changes over time during code reviews and changelog generation.

When do I need to include a body and footer in a commit message?

Include an optional body and footer in a commit message to capture rationale and breaking changes. This best practice supplements the required <type>(<scope>): <subject> syntax, providing additional context for team collaboration and release processes.

Does this commit message format work for automated changelog generation?

Yes, the conventional commit format enforces consistent, descriptive commit messages that are easily parsed for changelog generation. Standardizing type, scope, and subject allows automated tools to track changes during development and release processes.

What is the best way to standardize inconsistent git commit messages across a team?

The best way to standardize inconsistent git commit messages is enforcing a conventional commit structure with defined syntax and recommended practices. This approach constrains required types and scopes, making code changes easy to parse during reviews.

Why should I use a scope in my conventional commit subject?

You should use a scope in your conventional commit subject to specify the module or component affected by the code change. This descriptive practice supplements the required type and subject format, improving team collaboration and tracking.