Claude Code skill for intelligent Conventional Commits with breaking-change, issue-reference, and optional push support

claude-commit-skill

Intelligent Conventional Commits for Claude Code, in one command.

English

Install in one line

npx @hootbu/commit-skill

Restart Claude Code. From any project, just type /commit.

What it does

When you run /commit, the skill:

Reads your staged or unstaged diff
Picks a Conventional Commit type and scope
Writes a precise subject + bullet body
Detects breaking changes and adds the ! marker + BREAKING CHANGE: footer
Extracts issue refs from your branch name (Closes #123, Refs: PROJ-456)
Optionally pushes to origin — and prints the target branch first so you don’t slip into main by accident

If you have multiple unrelated changes, it splits them into separate commits and asks for confirmation before executing.

Commands

Command	Behavior
`/commit`	Staged → single commit. Nothing staged → batch mode.
`/commit --all`	Force batch mode: split into multiple logical commits
`/commit --push`	Commit, then auto-push to origin
`/commit -tr`	Turkish messages
`/commit -en`	English messages (default)
`/commit --help` / `-h`	Show this table

Flags compose freely: /commit --all --push -tr

Example

Single commit:

feat(auth): add token refresh logic for expired sessions

- add automatic retry when access token returns 401
- store refresh token in secure storage instead of shared prefs
- remove manual logout on token expiry, replace with silent refresh

Closes #234

Batch mode preview:

Proposed commits:

1. feat(wizard): add discount calculation to pricing step
   - src/components/wizard/PricingStep.tsx
   - src/lib/pricing.ts

2. fix(db): correct meeting balance view
   - supabase/migrations/20250102_fix_balance.sql

3. chore: update dependencies
   - package.json
   - package-lock.json

Proceed with these commits? (y/n)

Why people use it

No more vague messages. “fix stuff”, “update code” never happen again — every commit follows the same format.
Diff reading is automated. You think about the change; the skill reads the diff and writes the message.
Clean, reviewable history. Batch mode splits unrelated changes into separate commits instead of dumping them in one.
Safe push. Target branch is announced before any push, so accidental main pushes don’t happen silently.
Multilingual. English and Turkish out of the box; the type(scope): prefix always stays in English per the Conventional Commits standard.

Manual install

git clone https://github.com/hootbu/claude-commit-skill.git
mkdir -p ~/.claude/skills/commit
cp -r claude-commit-skill/SKILL.md claude-commit-skill/references ~/.claude/skills/commit/

How batch grouping works

A 5-phase algorithm — affinity pairing, directory clustering, semantic separation, balancing, ordering. Full spec in references/grouping-algorithm.md.

Contributing

Issues and PRs welcome. The skill is pure Markdown — SKILL.md is the spec Claude Code reads at runtime, no build step required. If you build a similar skill or extend this one, open an issue, I’d love to hear about it.

License

MIT

Türkçe

Tek komutla kurulum

npx @hootbu/commit-skill

Claude Code’u yeniden başlat. Herhangi bir projede /commit yaz, hazır.

Ne yapıyor

/commit yazdığında skill:

Staged veya unstaged diff’ini okur
Conventional Commit type ve scope seçer
Net bir subject + madde işaretli body yazar
Breaking change’leri tespit eder, ! işaretini ve BREAKING CHANGE: footer’ını ekler
Branch adından issue ref’leri çıkarır (Closes #123, Refs: PROJ-456)
İsteğe bağlı push yapar — ve önce hedef branch’i ekrana yazar, böylece yanlışlıkla main’e push’lamazsın

Birbirinden bağımsız birden fazla değişiklik varsa onları ayrı commit’lere böler ve her biri için önce onay ister.

Komutlar

Komut	Davranış
`/commit`	Staged varsa tek commit. Yoksa batch mode.
`/commit --all`	Batch mode’u zorla: çoklu mantıksal commit’lere böl
`/commit --push`	Commit + otomatik push (origin’e)
`/commit -tr`	Türkçe mesaj
`/commit -en`	İngilizce (varsayılan)
`/commit --help` / `-h`	Bu tabloyu göster

Flag’ler özgürce birleşir: /commit --all --push -tr

Örnek

Tek commit:

feat(auth): expired session'lar için token refresh ekle

- access token 401 dönerse otomatik retry yap
- refresh token'ı shared prefs yerine secure storage'a koy
- token expiry'de manuel logout'u kaldır, silent refresh kullan

Closes #234

Batch mode önizleme:

Önerilen commit'ler:

1. feat(wizard): pricing step'e indirim hesaplaması ekle
   - src/components/wizard/PricingStep.tsx
   - src/lib/pricing.ts

2. fix(db): meeting balance view'ını düzelt
   - supabase/migrations/20250102_fix_balance.sql

3. chore: bağımlılıkları güncelle
   - package.json
   - package-lock.json

Bu commit'lerle devam edilsin mi? (y/n)

Neden tercih ediliyor

Belirsiz mesajlar bitti. “fix stuff”, “update code” gibi mesajlar artık yok — her commit aynı formatı takip eder.
Diff okuma otomatik. Sen değişikliği düşün, skill diff’i okuyup mesajı yazsın.
Temiz, review edilebilir history. Batch mode bağımsız değişiklikleri tek commit’e tıkmak yerine ayrı commit’lere böler.
Güvenli push. Push’tan önce hedef branch ekrana yazılır — main’e kazara push sessizce olmaz.
Çok dilli. EN/TR varsayılan olarak destekleniyor; type(scope): prefix’i Conventional Commits standardı gereği her zaman İngilizce kalır.

Manuel kurulum

git clone https://github.com/hootbu/claude-commit-skill.git
mkdir -p ~/.claude/skills/commit
cp -r claude-commit-skill/SKILL.md claude-commit-skill/references ~/.claude/skills/commit/

Batch grouping nasıl çalışır

5 fazlı algoritma — yakınlık eşleşmesi, dizin kümeleme, semantik ayrım, dengeleme, sıralama. Tam spesifikasyon: references/grouping-algorithm.md.

Katkıda bulunma

Issue ve PR’lar memnuniyetle. Skill tamamen Markdown ile yazılmış — SKILL.md Claude Code’un çalışma anında okuduğu spec’tir, build adımı yok. Benzer bir skill yapıyorsan veya bunu genişletiyorsan, issue aç, görmek isterim.

Lisans

MIT