| name | maji-commit |
| description | Generate a concise commit message from the current git diff. Conventional commits format (feat/fix/refactor/etc). Use when staged changes are ready to commit and you want Claude to write the message instead of typing it manually. |
maji-commit — Auto-generate Commit Messages
A skill that reads your staged or unstaged git diff and writes a clean commit message in conventional commits format. No manual typing, no overthinking the wording.
When to Use
Type maji-commit (or commit message?) after running git diff or git diff --staged. Claude reads the diff, infers the change, outputs a commit message you can copy-paste.
Input → Output
Input: Current staged/unstaged diff in the working directory.
Output: A single commit message string in conventional commits format.
<type>(<scope>): <subject>
[optional body — only if change is non-obvious]
Format Rules
Type (required)
| Type | When to use |
|---|
feat | New feature or capability |
fix | Bug fix |
refactor | Code restructure, no behaviour change |
chore | Tooling, deps, config |
docs | Documentation only |
style | Formatting, no logic change |
test | Tests added or changed |
perf | Performance improvement |
build | Build system, packaging |
ci | CI/CD changes |
Scope (optional)
A noun describing the affected area: auth, api, ui, db, etc. Use when it adds clarity. Skip when scope is obvious or change spans multiple areas.
Subject
- Imperative mood ("add", "fix", "remove" — not "added", "fixes", "removed")
- Lowercase first letter
- No period at end
- ≤ 72 characters
- Describe what changed, not how
Body (only when needed)
Skip if subject is clear. Include only when:
- Non-obvious decision needs explaining
- Breaking change (prefix body with
BREAKING CHANGE:)
- Multiple loosely-related changes (rare — usually means split into multiple commits)
Examples
Single-line commits (most common)
feat(auth): add Google OAuth flow
fix(dashboard): resolve search input race condition
refactor(api): extract user service from controller
chore: update dependencies to latest stable
docs(readme): add installation troubleshooting section
test(auth): add login flow integration tests
Commits with body (less common)
fix(payment): handle webhook retry idempotency
Stripe sends duplicate webhook events on retry. Previous
implementation processed each, causing double-charges.
Now check event ID against processed log before handling.
refactor(db): switch from raw SQL to Drizzle ORM
BREAKING CHANGE: Query helpers in lib/db.ts now return
Drizzle query builders instead of raw rows. Callers must
update to use .execute() or .all() pattern.
Anti-patterns to Avoid
| ❌ Avoid | ✅ Better |
|---|
Updated stuff | feat(api): add user search endpoint |
Fixed bug | fix(auth): handle expired token refresh |
Various changes | Split into multiple commits with specific messages |
WIP | Skip the commit; or use chore: wip [reason] if must |
Final changes | Describe what the changes do, not their finality |
Updated dependencies and added some features | Split: chore: update deps + feat(x): add y |
Workflow
- User stages changes:
git add ...
- User runs
git diff --staged (optional, for review)
- User invokes
maji-commit in Claude
- Claude reads diff via tool call (Bash
git diff --staged)
- Claude outputs commit message
- User copy-pastes into
git commit -m "..." or commits directly
If using Claude Code with permissions, Claude can run git commit -m "<generated>" directly when authorized.
Customization
Some teams use additional types or scopes. To customize, fork this skill and edit the type table above. Common additions:
revert — reverting a previous commitmerge — merge commit (rarely needed)wip — work-in-progress (discouraged; signals incomplete commit hygiene)
To match your team's style, also adjust:
- Subject case rules (some teams prefer Sentence case, not lowercase)
- Subject length (some prefer ≤ 50 chars for terminal display)
- Body required vs optional
Composes With maji-mode
When maji-mode is active, maji-commit inherits its token discipline — no preamble like "Here's your commit message:", just the deliverable. Output is the commit string and nothing else.
maji-commit is part of MAJI Skills · By MAJI · No Codes, Only Vibes.
