# Git Conventional

> Enforce conventional commits, draft changelog entries, and suggest semantic version bumps.

- Skill: `eddieran/git-conventional` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add eddieran/git-conventional`
- Raw SKILL.md: https://api.skillmd.com/api/skills/eddieran/git-conventional/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: eddieran (https://skillmd.com/u/eddieran)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/eddieran/git-conventional

---


# Git Conventional

Use this skill when the user wants consistent commit messages, release notes, or a version bump recommendation.

## Agent Compatibility

- Claude Code: supported
- Codex: supported

## Inputs

- A diff, commit list, or branch summary
- The current release version when known
- Any project-specific commit prefixes or release policy

## Workflow

1. Classify each change using conventional commit semantics.
2. Highlight ambiguous changes that need a tighter scope or clearer description.
3. Draft changelog entries grouped by change type.
4. Recommend the smallest valid semantic version bump.
5. Call out breaking changes explicitly.

## Output Contract

- Suggested commit subject line
- Optional body bullets when the change deserves context
- Changelog entry grouped by type
- Version bump recommendation with rationale

## Guardrails

- Do not overstate a breaking change without an actual compatibility break.
- Do not hide risk behind vague scopes like `misc` or `update`.
- Prefer one coherent commit story over a noisy list of file names.