Commit Curator

commit-curator

> Groups uncommitted changes into logical commits with messages that match the repo's existing style. No more "wip" or "fix stuff" commits.

When to activate

Trigger phrases: commit, git commit, ship this, push these changes.

Skip when:

• Working tree is clean (git status shows nothing)
• User pasted a specific commit message ("commit with 'feat: add x'")
• In the middle of an active rebase/merge

Process

1. Run git status and git diff --staged + git diff (unstaged)
2. Group files by intent:

• Same feature touching multiple files → one commit
• Refactor that touches X files but is one idea → one commit
• Test additions for a new feature → bundle with the feature, OR separate commit if tests came first
• Unrelated bugfix → separate commit

1. Read recent git log -10 --oneline to detect message style (conventional commits, plain, prefix-based, gitmoji)
2. Draft N commits with proposed messages + file list
3. Show user the plan:

``` Plan:

1. feat: add rate-limit middleware (3 files)

• middleware/rate_limit.py
• tests/testratelimit.py
• config/limits.yaml

1. chore: bump fastapi 0.115 → 0.116 (1 file)

• requirements.txt

1. fix: nil pointer in cache eviction (1 file)

• cache/lru.go

Approve? (y / edit / split N / merge N+M) ```

1. On approval, run git add + git commit -m "..." per group

Inputs

• Working tree state (staged + unstaged + untracked)
• Recent commit history (for style match)

Outputs

• 1+ commits with curated messages
• Final git status (should be clean if all changes committed)

Style detection

• If recent commits use feat:, fix:, chore:, docs:, refactor: → conventional
• If recent commits use sentence case ("Add rate limit middleware") → plain
• If they use emoji prefixes → match it
• If short, mostly imperative → match length

Safety

• Never commits .env, files matching .gitignore, large binaries
• If a file is staged with secrets (regex scan for AWS_KEY, sk-ant, etc.), refuse and warn
• Never force-push, never amend without explicit user say-so

Slash command

/commit — invoke the curator on current working tree.

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: timdevai
• Source: timdevai/proteus
• License: MIT

Install and usage instructions live in the source repository linked above.