marcelorodrigo avatar

Conventional Commit

This walks you through the Conventional Commits spec with practical examples and a prerequisite check to keep you off the main branch. You get a clean table of commit types (feat, fix, refactor, etc.), formatting rules like the 70-character subject line limit, and real examples showing how to handle breaking changes and reverts. The guidance on writing bodies is solid: explain what and why, not how. If you've been on teams where commit messages are a mess or you're trying to enable semantic versioning, this gives you a consistent template. It's opinionated in the right ways, like insisting on imperative mood and branch naming that matches commit types.

skills.sh installs
962
GitHub stars
19
last updated
Aug 21, 2026

Install

$ npx -y skills add marcelorodrigo/agent-skills --skill conventional-commit --agent claude-code

Installs into .claude/skills of the current project.

Files

Conventional Commit Messages

Follow these conventions when creating commits.

Prerequisites

Before committing, ensure you're working on a feature branch, not the main branch.

# Check current branch
git branch --show-current

If you're on main or master, create a new branch first:

# Create and switch to a new branch
git checkout -b <type>/<short-description>

Branch naming should follow the pattern: <type>/<short-description> where type matches the commit type (e.g., feat/add-user-auth, fix/null-pointer-error, refactor/extract-validation).

Format

<type>(<scope>): <subject>

<body>

<footer>

The header is required. Scope is optional. All lines must stay under 100 characters.

Commit Types

Sponsors

Details

Repository
github.com/marcelorodrigo/agent-skills
Categories
Git & Pull Requests, Documentation, AI & Agent Building
First seen
May 16, 2026

More from marcelorodrigo/agent-skills

All 4
1asyrafhussin avatargit-workflowasyrafhussin/agent-skillsGit best practices, branching strategies, commit conventions, and PR workflows. Use when reviewing git history, writing commits, setting up branching strategy, 890skills.sh installs
2github avatargithub-releasegithub/awesome-copilotGuides IA through releasing a new version of a GitHub library end-to-end. Handles SemVer versioning and Keep a Changelog formatting automatically.790skills.sh installs
3google-labs-code avatarautomate-github-issuesgoogle-labs-code/jules-skillsSet up automated GitHub issue triage and resolution using parallel Jules coding agents759skills.sh installs
4ruvnet avatardiff-analyzeruvnet/rufloAnalyze git diffs for risk scoring, reviewer recommendations, and change classification. Use when preparing a PR, reviewing a large or cross-module change, or b753skills.sh installs
5ruvnet avatargit-workflowruvnet/rufloAdvanced git workflows with branch management, conflict resolution, and PR lifecycle743skills.sh installs
6cockroachdb avatarcommit-helpercockroachdb/cockroachHelp create git commits and PRs with properly formatted messages and release notes following CockroachDB conventions. Use when committing changes or creating pu642skills.sh installs