---

name: commit description: Generate a Conventional Commits message, commit, and optionally push to remote. argument-hint: "[--push] (auto commit & push without prompting)" when-to-use: "user wants to commit changes or write a commit message -- '/commit', 'commit this', 'make a commit', 'git commit', 'commit my changes'"

Gather Git Context

!`git rev-parse --is-inside-work-tree 2>/dev/null || echo "NO_GIT"`

!`git status --short 2>/dev/null || echo "NO_GIT"`

!`git diff --cached 2>/dev/null || echo "NO_GIT"`

!`git log --oneline -10 2>/dev/null || echo "NO_COMMITS"`

---

Instructions

Step 0 -- Git Availability

If any gather-context block above returned NO_GIT, this directory is not a git repository. Print: > No git repository detected. /commit requires a git repo. Stop here.

---

Silently determine which case applies — do not show the case label or decision logic to the user:

• No changes: If git status is empty → tell the user and stop.
• Nothing staged: If git diff --cached is empty but git status shows changes → tell the user to stage files and run /quiver:commit again, then stop.
• Staged changes exist: Proceed silently to Commit Message Generation.

---

Commit Message Generation

Analyze git diff --cached and the recent log. Generate a Conventional Commits message following these rules:

Type — Select one based on primary intent:

Type	When to Use
feat	New feature or capability visible to users
fix	Bug fix
docs	Documentation only (README, comments, JSDoc)
style	Formatting, whitespace, semicolons — no logic change
refactor	Code restructuring with no behavior change
perf	Performance improvement
test	Adding or fixing tests
build	Build system or external dependencies (npm, Makefile)
ci	CI/CD configuration (GitHub Actions, CircleCI)
chore	Maintenance tasks (version bumps, tooling config)
revert	Reverting a previous commit

Scope — From file paths: single directory → its name, single file → domain name, cross-cutting → omit.

Breaking changes — If the change removes/renames public APIs, changes signatures, alters data formats, or removes CLI flags/commands, add ! after type/scope and a BREAKING CHANGE: footer.

Subject line — Imperative mood, lowercase after colon, no period, ≤72 chars total, describe what not how.

Body — Almost never. Only for breaking changes or when the subject alone would be misleading. Wrap at 72 chars. Never include file lists — git log --stat shows this.

Footers — BREAKING CHANGE: if applicable. Refs: #issue if relevant.

---

Output

Important: The user must see the full commit message before answering the prompt. Print it to the chat stream and keep the AskUserQuestion question itself to one short line -- see Default (no flag) below.

Include a body or footers only for breaking changes or multi-type changes where the subject alone is genuinely ambiguous. Default to subject-only. Don't add Co-authored-by or attribution footers unless explicitly requested.

Flag: --push

If $ARGUMENTS contains "push" (e.g., /quiver:commit --push), skip the AskUserQuestion step entirely. Instead, show the generated commit message, then immediately execute Commit & Push (commit + push to remote) without prompting.

Default (no flag)

Two steps, both mandatory: print the message, then ask. Do not paste the commit message into the AskUserQuestion question field -- that field is rendered as a single truncated line by some Claude Code surfaces, so a multi-line message is cut off or dropped entirely and the user is asked to approve something they cannot read.

Step 1 -- print the message as normal chat output, verbatim inside a fenced block, so the user sees exactly what git commit will receive:

{type}({scope}): {subject}

{body lines, if the message has a body}

Step 2 -- ask, and wait for the answer:

• Question: "Commit this?" -- one short line. No newlines, no message text, no ANSI escape codes. AskUserQuestion renders the question in a TUI box that prints escape sequences literally instead of styling them.
• Header: "Action"
• Options:
  1. Commit — "Commit with this message"
  2. Commit & Push — "Commit and push to remote"
  3. Edit — "Revise the message"
  4. Cancel — "Abort without committing"

Printing the message is not approval. It is only the readable copy of what the prompt is about, and it exists because the prompt cannot display it. Never run git commit without an answer from this AskUserQuestion. The user asking for a commit in their message is not the answer either -- that is what put the skill on this step. --push is the only path that skips the prompt.

---

Commit Execution

On commit or commit & push:

1. Commit using a HEREDOC:

   git commit -m "$(cat <<'EOF'
   {full commit message}
   EOF
   )"
   

2. Verify: git log --oneline -1 and git status --short.

If commit & push, also:

3. Detect branch: git branch --show-current
4. Push: if git rev-parse --abbrev-ref @{upstream} 2>/dev/null succeeds → git push, otherwise → git push -u origin {branch}
5. Verify push exit code is 0.

Output:

Committed: {short hash} {subject} Branch: {branch name} Pushed to: origin/{branch} (only if pushed)

On edit: Ask what to change, revise, re-present, and ask again.

On cancel:

Commit cancelled. Staged changes are intact.

Stop here.

---

Error Handling

If git commit fails, show the error verbatim and suggest the user fix the issue and re-run /quiver:commit. Never retry automatically or use --no-verify.