conventional-commits

Guide teams to craft conventional commit messages with types and scopes.

2|Updated Apr 12, 2026
One-click install
npx skills add https://github.com/PequiProject/pequi --skill conventional-commits-pequiproject
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: conventional-commits
Source: https://github.com/PequiProject/pequi/tree/main/.agents/skills/conventional-commits
Command: npx skills add https://github.com/PequiProject/pequi --skill conventional-commits-pequiproject

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Unclear or inconsistent commit histories hinder collaboration and automation. This skill standardizes commit messages using the Conventional Commits specification to improve readability, changelog generation, and tooling compatibility.

Core Features & Use Cases

  • Types and Scope: defines commit types (feat, fix, docs, style, refactor, perf, test, chore) and optional scopes for modules.
  • Guided Commit Messages: offers templates and examples for typical changes, code reviews, and changelog workflows.
  • Automation Friendly: aligns with CI checks and tooling that parse commit messages for release notes.

Quick Start

Create a commit using the conventional-commits format for your next change.

Frequently Asked Questions about conventional-commits

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

FAQPage Schema
What is the conventional commits format for git commit messages?

The conventional commits format structures git commit messages using predefined types like feat, fix, docs, and refactor, along with optional scopes, to standardize commit history and improve readability across software projects.

How do I write a conventional commit message for a bug fix or feature?

To write a conventional commit message, start with a type such as feat or fix, add an optional scope in parentheses, then provide a concise description. This skill provides templates and real-world examples to guide the formatting.

Does conventional commits work with CI checks and changelog generation tooling?

Yes, conventional commits is automation friendly and aligns with CI checks and tooling that parse commit messages. Standardizing types and scopes enables automated release notes and changelog generation.

What is the best way to standardize commit messages across a development team?

The best way to standardize commit messages is applying the conventional commits specification. It enforces a structured format covering types, scopes, and formatting rules to ensure consistency in code reviews and collaboration workflows.

When do I need to use scopes in conventional commit messages?

You use scopes in conventional commit messages to specify the module or component affected by the change. Scopes are optional but help categorize commits within larger software projects for better changelog tracking.

Why does inconsistent commit history hinder collaboration and automation?

Inconsistent commit history hinders collaboration and automation because unstructured messages cannot be parsed for changelog generation or CI checks. Conventional commits solves this by enforcing a standardized commit message structure.