git

Validate commit messages against the Conventional Commits specification.

56|2|Updated Feb 8, 2026
One-click install
npx skills add https://github.com/matteing/opal --skill git-matteing
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: git
Source: https://github.com/matteing/opal/tree/main/.claude/skills/git
Command: npx skills add https://github.com/matteing/opal --skill git-matteing

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Enforcing a strict conventional commit format prevents inconsistent commit messages, messy changelogs, and incorrect semantic version bumps, making releases and code review clearer and more automatable.

Core Features & Use Cases

  • CommitMessage Validation: Require a type, optional scope, and a lowercase imperative description to ensure uniform messages.
  • Release and Changelog Hygiene: Enable predictable changelog generation and semantic versioning by mapping types to version bumps.
  • Guidance and Examples: Provide scope recommendations for repo areas like core, cli, rpc, agent, tools, and release, plus examples for breaking changes and footers.
  • Use Case: When preparing a PR, use this Skill to rewrite or validate commit messages so automated changelog generation and CI release steps work reliably.

Quick Start

Create a conventional commit message for a bug fix in the core module with the description prevent crash when tool returns empty response.

Frequently Asked Questions about git

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

FAQPage Schema
How do I enforce conventional commit messages for automated changelog generation?

Use conventional commit validation to require a type, optional scope, and lowercase imperative description. This ensures uniform conventional commits and enables predictable changelog generation and semantic versioning.

What is the correct format for a conventional commit message with a breaking change?

A conventional commit message with a breaking change requires a type, optional scope, lowercase imperative description, and a breaking change marker. The format includes specific body and footer formatting to signal semantic versioning bumps.

How do I structure a conventional commit for a bug fix in the core module?

Structure a conventional commit for a core module bug fix by using the fix type with core as the scope, followed by a lowercase imperative description. An example is: fix(core): prevent crash when tool returns empty response.

Does semantic versioning automatically map commit types to version bumps?

Semantic versioning maps conventional commit types to version bumps. By enforcing strict commit message formats with validated types and scopes, release workflows can automatically determine major, minor, or patch version increments.

Why do my pull request commits fail automated release workflow checks?

Pull request commits fail automated release workflow checks when conventional commit messages lack required types, scopes, or lowercase imperative descriptions. Validating one logical change per commit ensures CI release steps and changelog generation work reliably.

When do I need conventional commits for git history hygiene?

You need conventional commits for git history hygiene when preparing pull requests or managing changes across core, cli, rpc, agent, tools, and release workflows. Enforcing this format ensures one logical change per commit and automatable code reviews.