commits

Validate Git commit messages against the Conventional Commits 1.0.0 specification.

Updated Jun 15, 2025
One-click install
npx skills add https://github.com/patrickhaahr/dotfiles --skill commits
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: commits
Source: https://github.com/patrickhaahr/dotfiles/tree/main/opencode/.config/opencode/skills/commits
Command: npx skills add https://github.com/patrickhaahr/dotfiles --skill commits

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps teams avoid ambiguous or inconsistent commit messages by ensuring every commit follows the Conventional Commits 1.0.0 specification, improving readability and automation.

Core Features & Use Cases

  • Enforce commit type prefixes (feat, fix, docs, style, refactor, test, chore) per the spec.
  • Validate optional scope formatting and provide guidance for descriptive summaries.
  • Generate or propose properly formatted commit messages after reviewing diffs and history for consistency.

Quick Start

Use this skill to draft a conventional commit message for the current changes after verifying diffs and history.

Frequently Asked Questions about commits

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

FAQPage Schema
How do I enforce conventional commit messages in a Git project?

To enforce conventional commit messages, a validation skill checks Git commit type prefixes like feat, fix, and docs against the Conventional Commits 1.0.0 specification. It validates type, scope, and description formatting to reduce ambiguity in project history.

What is the correct format for a conventional commit with a scope?

The correct conventional commit format requires a type prefix, an optional scope in parentheses, and a descriptive summary. This skill validates these elements against the Conventional Commits 1.0.0 specification and suggests the properly formatted message for your review.

How do I generate a properly formatted conventional commit message after reviewing a diff?

To generate a conventional commit message, review your Git diffs and history for consistency, then use this skill to draft a message. It applies the Conventional Commits 1.0.0 specification to propose a correctly formatted commit summary.

Does this conventional commit validator support all standard commit types?

Yes, this conventional commit validator supports standard types including feat, fix, docs, style, refactor, test, and chore. It enforces these type prefixes per the Conventional Commits 1.0.0 specification to improve readability and automation.

Why should my software engineering team use conventional commits?

Your team should use conventional commits to avoid ambiguous or inconsistent project history. Standardized commit messages following the Conventional Commits 1.0.0 specification improve readability and enable automation for release management.