CO

Formats and validates Git commit messages according to the Conventional Commits standard.

Install

mkdir -p .claude/skills/conventional-commit && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/1393" && unzip -o skill.zip -d .claude/skills/conventional-commit && rm skill.zip

Installs to .claude/skills/conventional-commit

Activation

This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.

Formats Git commit messages using the Conventional Commits standard and enforces project-specific linting rules.
112 charsno explicit “when” trigger
Beginner

Key capabilities

  • Format commit headers using Conventional Commits standard
  • Validate commit message structure against linting rules
  • Enforce maximum header length of 100 characters
  • Ensure subject lines lack trailing punctuation
  • Apply imperative present tense to commit descriptions

How it works

The skill analyzes staged changes to generate or validate commit messages based on predefined types and strict formatting rules.

Inputs & outputs

You give it
Staged Git changes
You get back
Compliant commit message header and body

When to use conventional-commit

  • Generate commit message from changes
  • Validate conventional commit structure
  • Standardize git commit headers

About this skill

Conventional Commit Skill

Use this skill to generate or validate Git commit messages.

Instructions

  1. Analyze Changes: Look at the staged changes (using git diff --cached) or provided content.
  2. Determine Type: Choose the most appropriate type from:
    • feat: A new feature
    • fix: A bug fix
    • chore: Maintenance or tool changes (Husky, EditorConfig, etc.)
    • docs: Documentation only changes
    • style: Changes that do not affect the meaning of the code (white-space, formatting, etc.)
    • refactor: A code change that neither fixes a bug nor adds a feature
    • perf: A code change that improves performance
    • test: Adding missing tests or correcting existing tests
  3. Format Header:
    • Format: <type>[optional scope]: <description>
    • CRITICAL: The header must NOT exceed 100 characters.
    • CRITICAL: The description must NOT end with a period/full stop.
    • Use imperative, present tense: "change", not "changed" or "changes".
    • Use lowercase for the starting character of the description.
  4. Body (Optional): Provide additional context if the change is complex. Wrap lines at 72 characters.
  5. Footer (Optional): Mention breaking changes or reference issues (e.g., Resolves #123).

Project Specifics

  • This project uses @commitlint/config-conventional.
  • Maximum header length: 100 characters.
  • No trailing punctuation in the subject line.

When not to use it

  • When writing commit messages that do not follow conventional standards
  • When the commit message exceeds 100 characters

Prerequisites

@commitlint/config-conventional

Limitations

  • Subject line must not end with a period
  • Strict 100-character limit for headers

How it compares

It enforces a standardized, machine-readable commit format that improves project history clarity compared to free-form messages.

Compared to similar skills

conventional-commit side by side with the closest alternatives in the catalog.

SkillInstallsUpdatedSafetyDifficulty
conventional-commit (this skill)36moNo flagsBeginner
resolve-conflicts818moReviewIntermediate
dependency-upgrade265moReviewIntermediate
git-commits214moNo flagsBeginner

Try saying

Example prompts that trigger this skill in your AI assistant.

Search skills

Search the agent skills registry