git-conventions

Enforce conventional commit format with allowed types and formatting rules.

3|1|Updated Nov 10, 2025
One-click install
npx skills add https://github.com/metraton/gaia --skill git-conventions-metraton
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: git-conventions
Source: https://github.com/metraton/gaia/tree/main/skills/git-conventions
Command: npx skills add https://github.com/metraton/gaia --skill git-conventions-metraton

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Ensures consistent, readable Git history by standardizing commit messages and PR preparation, reducing review friction and improving traceability.

Core Features & Use Cases

  • Enforces a conventional commit format: type(scope): short description
  • Defines allowed types (feat, fix, refactor, docs, test, chore, ci, perf, style, build)
  • Guides subject line rules: lowercase first character, imperative mood, max 72 chars, no period
  • Describes valid body and footer sections for detailed context
  • Provides examples for common scenarios such as feature work, bug fixes, and documentation updates

Quick Start

Follow the commit format rules to craft your next commit message.

Frequently Asked Questions about git-conventions

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

FAQPage Schema
How do I format git commit messages for features and fixes?

To format git commit messages, use the conventional structure type(scope): short description. Specify the type, scope, subject, body, and footers to ensure a clear, readable project history and reduce review friction.

What are the allowed commit types in a conventional git workflow?

Allowed commit types in a conventional git workflow include feat, fix, refactor, docs, test, chore, ci, perf, style, and build. Using these standard types categorizes changes to improve traceability and reduce review friction.

What are the rules for a git commit subject line?

Git commit subject line rules require a lowercase first character, imperative mood, a maximum of 72 characters, and no trailing period. Following these formatting rules ensures concise, readable commit titles for easier history navigation.

How do I write the body and footers for a git commit message?

Write the git commit body and footers by separating them from the subject with a blank line. Use the body for detailed context and footers for metadata, ensuring structured, traceable documentation for features and fixes.

When do I need conventional commit formatting in my git workflow?

You need conventional commit formatting when standardizing git history for features and fixes. It enforces consistent messages and PR preparation, reducing review friction and improving traceability across the project.