conventional-commit

Structure commit messages to follow the Conventional Commits specification.

1|Updated Mar 20, 2026
One-click install
npx skills add https://github.com/Thomashighbaugh/opencode --skill conventional-commit-thomashighbaugh
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: conventional-commit
Source: https://github.com/Thomashighbaugh/opencode/tree/main/skills/conventional-commit
Command: npx skills add https://github.com/Thomashighbaugh/opencode --skill conventional-commit-thomashighbaugh

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Inconsistent and ambiguous commit messages make it hard to understand changes, automate changelogs, and drive release/versioning; this Skill provides a clear, repeatable structure that machines and humans can parse reliably.

Core Features & Use Cases

  • Consistent, machine-readable commits: Enforces the Conventional Commits structure so tooling can generate changelogs, determine semantic version bumps, and integrate with CI.
  • Guided authoring and review: Helps draft imperative, concise headers, scoped changes, descriptive bodies, and footers for breaking changes or issue references.
  • Use Case: Use when drafting commit messages before coding, reviewing commit history for quality, or preparing automated release notes for a project.

Quick Start

Create a Conventional Commit message for a bug fix that removes a blocking overlay on the login button and closes issue #123.

Frequently Asked Questions about conventional-commit

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

FAQPage Schema
How do I write a conventional commit message that automatically generates a changelog?

To write a conventional commit message, structure it with an imperative concise header, an optional scope and body, and footer conventions for breaking changes or issue references. This machine-readable format allows tooling to automate changelog generation and semantic version bumps.

What is the conventional commit format for indicating breaking changes in git?

The conventional commit format uses footer conventions to indicate breaking changes, often marked with a specific notation. It requires an imperative concise header and optional scope and body to ensure the commit message is machine-readable for semantic version bumping.

How do I structure a git commit message for semantic versioning?

Structure your git commit message for semantic versioning by applying the Conventional Commits specification. Use an imperative concise header, an optional scope and body, and footers for issue references or breaking changes to trigger automated release generation.

Can I use conventional commits to draft messages before coding?

Yes, you can use conventional commits to draft messages before coding. This guided authoring approach helps define an imperative concise header, scoped changes, and descriptive bodies upfront, ensuring consistent software development workflows.

Does a conventional commit message require a body and scope?

A conventional commit message does not require a body and scope; they are optional. The specification mandates an imperative concise header, while the optional body and footer conventions are used for descriptive details, breaking changes, and issue references.

Why should I use conventional commits instead of plain git commit messages?

You should use conventional commits instead of plain git messages to solve the problem of inconsistent and ambiguous history. This structure provides a clear, repeatable format that both machines and humans can parse reliably for automating changelogs and releases.