conventional-commit

Draft, rewrite, and validate Conventional Commits messages and PR titles.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This skill helps teams ensure commit messages and PR titles follow the Conventional Commits standard, enabling consistent changelogs and easier automation.

Core Features & Use Cases

  • Enforce the <type>[optional scope]: <description> format in commits and PR titles.
  • Suggest appropriate type and scope based on code changes, and rewrite non-conforming messages.
  • Validate existing messages against the canonical specification and provide corrected options when needed.

Quick Start

Draft or rewrite a commit message or PR title to follow Conventional Commits guidelines.

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 for a feature or fix?

To write a conventional commit message, enforce the header format <type>[optional scope]: <description>. Keep descriptions imperative and concise, using types like feature, fix, docs, or chore to ensure consistent changelogs and semantic clarity.

What is the conventional commits format for semantic PR titles?

The conventional commits format for semantic PR titles requires the structure <type>[optional scope]: <description>. This standardizes code review and git workflow by keeping titles imperative, concise, and categorically typed for easier automation.

How do I validate existing commit messages against the conventional commits specification?

You can validate existing commit messages by checking them against the canonical conventional commits specification. The validation process enforces the header format and surfaces corrected options when messages do not comply with repo-local guidelines.

Can I rewrite a non-conforming git commit message to follow the standard?

Yes, you can rewrite non-conforming git commit messages to follow the standard. The process suggests appropriate type and scope based on code changes, applying the <type>[optional scope]: <description> format to update feature, fix, docs, and chore commits.

Does this conventional commit linter support repo-local guidelines for code review?

Yes, this conventional commit linter supports repo-local guidelines for code review. It checks commit messages and semantic PR titles against repository-specific rules, enforcing the header format and providing corrected options for non-compliant entries.

What are the limitations of enforcing conventional commit messages in a git workflow?

Limitations of enforcing conventional commit messages involve strictly adhering to the <type>[optional scope]: <description> header format. Messages must remain imperative and concise, and non-conforming updates require rewriting to pass semantic PR title checks and repo-local validation.