commit-helper

A Claude Code skill that generates conventional commit messages from git diffs.

What it does

When you ask Claude Code to write a commit message, commit-helper automatically:

1. Reads git diff --cached to see what's staged
2. Analyzes the changes to determine commit type (feat, fix, refactor, etc.) and scope
3. Detects breaking changes automatically
4. Presents 2–3 formatted options for you to choose from
5. Executes git commit with your selection

Installation

One-liner

# macOS / Linux
curl -sL https://raw.githubusercontent.com/<your-username>/commit-helper/main/install.sh | bash

# Windows (PowerShell)
irm https://raw.githubusercontent.com/<your-username>/commit-helper/main/install.ps1 | iex

Manual

Copy SKILL.md to Claude Code's skills directory:

# macOS / Linux
mkdir -p ~/.claude/skills/commit-helper
cp SKILL.md ~/.claude/skills/commit-helper/

# Windows
mkdir %USERPROFILE%\.claude\skills\commit-helper
copy SKILL.md %USERPROFILE%\.claude\skills\commit-helper\

Project-level (recommended for teams)

Place it in your project's .claude/skills/ directory and commit it to the repo:

mkdir -p .claude/skills/commit-helper
cp SKILL.md .claude/skills/commit-helper/
git add .claude/skills/commit-helper/SKILL.md

Usage

Just ask Claude Code to write a commit:

> git add .
> write a commit message

Or be more specific:

> help me write a commit for these changes
> create a commit message for what I just changed
> git commit

Claude will analyze your staged changes and present options like:

📂 3 files changed (src/api.js, src/db.js, package.json)
🔍 feat + fix + chore

Recommendations:
 1️⃣ feat(api): add user profile endpoint
 2️⃣ feat: add user profile endpoint and fix DB connection leak
 3️⃣ [detailed]

Pick a number and Claude commits it.

Commit types

Type	When to use
feat	A new feature
fix	A bug fix
refactor	Code change that neither fixes a bug nor adds a feature
perf	Performance improvement
style	Code formatting (not CSS)
docs	Documentation only
chore	Build/config/tooling changes
ci	CI configuration
test	Adding or fixing tests
revert	Reverting a previous commit
BREAKING CHANGE	API incompatibility (footer)

License

MIT