---

name: commit description: Stage and commit changes with a Conventional Commits message. Invoke with /commit "optional scope hint". Inspects the diff, picks an appropriate type and scope, writes a concise message, and commits. Does not push. user-invocable: true disable-model-invocation: true allowed-tools: Bash(git status:), Bash(git diff:), Bash(git add:), Bash(git commit:), Bash(git log:*) argument-hint: "[optional scope or context]"

/commit

Stage everything currently modified and untracked, then commit with a Conventional Commits message inferred from the diff.

Workflow

1. Run git status and git diff --staged (plus git diff for unstaged) to see what's actually changing. If nothing is changing, stop and say so.
2. Read git log -10 --oneline to match the repo's existing commit style — some repos use feat(bubbles): ..., others use bubbles: ..., others use sentence case. Match what's there, don't impose Conventional Commits if the repo doesn't use it.
3. Pick a type: feat, fix, refactor, docs, test, chore, perf, build, ci, style, revert. If $ARGUMENTS is non-empty, treat it as a scope or context hint, not as the full message.
4. Write a subject line ≤ 72 chars, imperative mood ("add", not "added"). If the change is non-obvious, add a body paragraph explaining the why — not the what (the diff already shows the what).
5. git add -A then git commit -m "...". Show the resulting git log -1 and stop. Do not push.

Rules

• One commit per invocation. If the diff spans unrelated changes, stop and tell the user to stage selectively instead of guessing.
• Never amend, force, or rewrite history from this skill — those are separate, dangerous operations and belong in their own skill.
• Never add Claude as co-author or include "Generated by" footers unless the repo's existing log shows that pattern.
• If pre-commit hooks fail, surface the failure and stop. Don't --no-verify.

Examples

/commit on a diff that touches internal/tui/textarea/buffer.go: → feat(textarea): add gap buffer backing store

/commit "rollback" on a diff that reverts a flag default: → revert: restore default --color=auto behavior