check-commit-message

Validate Git commit messages against Conventional Commits rules.

Updated Mar 19, 2026
One-click install
npx skills add https://github.com/sunLeee/optimization --skill check-commit-message
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: check-commit-message
Source: https://github.com/sunLeee/optimization/tree/main/.claude/skills/quality/check/check-commit-message
Command: npx skills add https://github.com/sunLeee/optimization --skill check-commit-message

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Git commit messages often fail to follow a consistent convention, hindering readability and automation.

Core Features & Use Cases

  • Validates messages against Conventional Commits rules.
  • Checks type, scope, subject, body, and footer for correctness.
  • Supports single-message validation, recent-history checks, and staged changes; integrates with pre-commit hooks or CI.

Quick Start

Run /check-commit-message "feat(api): Add user endpoint" to validate a single message, or use --recent N or --staged for batch checks.

Frequently Asked Questions about check-commit-message

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

FAQPage Schema
How do I validate git commit messages against conventional commits rules?

To validate git commit messages against conventional commits rules, you can check a single message, recent history, or staged changes to evaluate type, scope, subject, body, and footer for correctness.

How do I enforce conventional commit messages automatically in a pre-commit hook?

You can enforce conventional commit messages automatically by integrating validation into pre-commit hooks or CI pipelines, checking staged changes and outputting validation results and guidance before commits proceed.

What does a conventional commits validator check in a git commit message?

A conventional commits validator checks the type, scope, subject, body, and footer of a git commit message to ensure adherence to formatting rules, enforcing quality and consistency.

Can I check recent git history for conventional commits compliance?

Yes, you can check recent git history for conventional commits compliance by validating recent commits in batch, ensuring past type, scope, and subject structures follow the required convention.

Why do my git commit messages fail conventional commits validation?

Git commit messages fail conventional commits validation when the type, scope, subject, body, or footer does not match expected formatting rules, outputting specific guidance to correct the structure.