conventional-commit-guard

Validate git commit messages against the Conventional Commits specification.

1|Updated Feb 28, 2026
One-click install
npx skills add https://github.com/muddyrain/valley-mas --skill conventional-commit-guard
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: conventional-commit-guard
Source: https://github.com/muddyrain/valley-mas/tree/main/.codex/skills/conventional-commit-guard
Command: npx skills add https://github.com/muddyrain/valley-mas --skill conventional-commit-guard

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

规范 git 提交信息,使其遵循 Conventional Commits 规范,减少风格漂移并提升提交历史的可读性。

Core Features & Use Cases

  • 检查最近 5 条提交的风格以避免风格漂移
  • 强制首行遵守 type(scope): summary 或 type: summary 的格式
  • summary 默认使用中文且简洁,避免空泛描述;必要时可通过 amend 对齐历史

Quick Start

直接在提交时让 AI 生成符合 Conventional Commits 的首行信息。

Frequently Asked Questions about conventional-commit-guard

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

FAQPage Schema
How do I enforce Conventional Commits formatting for my git history?

To enforce Conventional Commits formatting, this skill validates your git commit header to ensure it follows the type(scope): summary or type: summary format, checking the five most recent commits to align history and prevent style drift.

What is the correct format for a conventional commit message summary?

A conventional commit message summary requires a type(scope): summary or type: summary format on the first line. The summary should be concise, avoid vague descriptions, and defaults to Chinese to maintain repository style.

How do I align a new commit with existing git history styles?

To align a new commit with existing git history styles, the skill analyzes the five most recent commits and amends your current commit message when needed to ensure it matches the established conventional commits style.

Can I use this to check multi-contributor commit messages?

Yes, you can use this to check multi-contributor commit messages. It is designed specifically for multi-contributor software projects to enforce consistent git commit messages and reduce style drift across the repository.

Why does my git commit message style keep drifting in a multi-contributor project?

Git commit message style drifts in multi-contributor projects because of inconsistent formatting practices. This skill mitigates the issue by checking the last five commits and amending messages to strictly follow Conventional Commits guidelines.