git-conventional-commits

Generates Conventional Commits messages by analyzing staged git diffs.

4|Updated Aug 8, 2026
One-click install
npx skills add https://github.com/alexeyshishin/as-skill --skill git-conventional-commits-alexeyshishin
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: git-conventional-commits
Source: https://github.com/alexeyshishin/as-skill/tree/main/domains/git/skills/git-conventional-commits
Command: npx skills add https://github.com/alexeyshishin/as-skill --skill git-conventional-commits-alexeyshishin

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Writing meaningful, convention-compliant commit messages is repetitive and often results in vague entries like "chore: update". This Skill analyzes your actual changes and drafts a properly formatted Conventional Commits message, so your git history stays consistent and informative. ## Core Features & Use Cases - Diff-Based Message Generation: Reads the staged diff (or unstaged if staged is empty) plus recent commit history to determine the correct type, scope, and subject language. - Convention Enforcement: Applies the full Conventional Commits ruleset — type selection (feat, fix, refactor, docs, etc.), kebab-case scopes, imperative subjects of 50-72 characters, and mandatory AI-attribution trailers. - Mixed-Change Detection: Detects when a diff combines unrelated changes (e.g., a fix plus a refactor) and suggests splitting them into separate commits instead of writing a misleading message. - Use Case: You finished fixing a login bug across two files. Instead of composing the message yourself, you ask for a commit — the Skill inspects the diff, proposes "fix(auth): correct token validation on login", and commits only after your confirmation. ## Quick Start Ask the assistant to commit the current changes following the Conventional Commits convention.

Frequently Asked Questions about git-conventional-commits

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

FAQPage Schema
How do I write a Conventional Commits message automatically?

Stage your changes and ask for a commit. The Skill runs git diff --staged, determines the type (feat, fix, refactor, etc.) and scope from the changed files, writes an imperative subject, and shows the message for your confirmation before committing.

How to choose the right commit type for my changes?

The type is derived from the diff content: new functionality is feat, bug fixes are fix, behavior-preserving restructuring is refactor, documentation-only changes are docs, and dependency updates are chore(deps). Mixed diffs trigger a suggestion to split into multiple commits.

Does it commit without my confirmation?

No. The Skill always shows the proposed message first and waits for explicit approval. You can accept it, adjust the subject or body, split the changes into several commits, or cancel entirely.

What happens if my diff contains unrelated changes?

The Skill stops and suggests splitting the work into separate commits rather than writing a combined message like "feat: fixed a bug and refactored", which is treated as an anti-pattern.

Why does every commit include a Co-Authored-By trailer?

The repository's git-conventions rule requires AI attribution on every commit, so the footer always includes "Co-Authored-By: Claude <[email protected]>". The Skill avoids duplicating the trailer if you already added one manually.