commit-validator

Validate commit messages against the Conventional Commits specification.

36|6|Updated Nov 2, 2025
One-click install
npx skills add https://github.com/oimiragieo/LLM-RULES --skill commit-validator
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: commit-validator
Source: https://github.com/oimiragieo/LLM-RULES/tree/main/.claude/skills/commit-validator
Command: npx skills add https://github.com/oimiragieo/LLM-RULES --skill commit-validator

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Programmatically validates commit messages against the Conventional Commits specification, providing instant feedback during development.

Core Features & Use Cases

  • Before committing code: Validate header format
  • In pre-commit hooks: Enforce standards locally
  • In CI/CD pipelines: Enforce across the team
  • During code review: Flag non-conforming messages
  • To enforce team standards: Consistent commit history

Quick Start

Validate commit message: feat(auth): add OAuth2 login support

Frequently Asked Questions about commit-validator

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

FAQPage Schema
How do I validate commit messages against Conventional Commits?

Conventional Commits validation enforces a standardized message format: <type>(<scope>): <subject>. Allowed types are feat, fix, docs, style, refactor, perf, test, chore, ci, build, and revert. The subject must be imperative, lowercase, without a period. The Skill parses your commit message and returns structured results showing validity, type, scope, and any errors or warnings.

Can I use commit validation in pre-commit hooks and CI/CD pipelines?

Yes. Commit validation works before commits locally via pre-commit hooks, in CI/CD pipelines to enforce team standards, and during code reviews. This catches non-conforming messages early, preventing inconsistent commit history across your project.

What commit message format does Conventional Commits require?

Conventional Commits requires the header format <type>(<scope>): <subject>, where type is mandatory (feat, fix, docs, style, refactor, perf, test, chore, ci, build, revert), scope is optional, and subject must be imperative and lowercase without a trailing period. Body and footer sections are allowed after a blank line.

Why should I enforce standardized commit messages across my team?

Standardized commit messages via Conventional Commits make your project history readable, enable automated changelog generation, and improve collaboration. The Skill validates messages consistently across development, pre-commit stages, and CI pipelines, ensuring all contributors follow the same format.

What output does the commit validator return?

The validator returns a structured result containing the parsed type, scope, subject, a validity flag, and any warnings or errors encountered. This structured feedback lets you programmatically handle validation results in hooks, pipelines, and code review workflows.

Does commit validation work with existing git workflows?

Yes. Commit validation integrates into existing git workflows through pre-commit hooks, CI/CD pipelines, and manual code review processes. It requires no changes to your repository structure and returns results that fit into any automation or review system.