Smart Commit

Overview

Self-contained workflow to mirror the smart-commit CLI: staged diff → structured prompt → clean commit message. Use inside a git repo when someone calls /smart-commit or requests a commit message.

Workflow

1. •Check repo and staging

• •Confirm you are in a git repo (git rev-parse --is-inside-work-tree) and show git status -sb.
• •If nothing is staged, ask before staging (git add <files>); do not stage automatically unless the user approves.

1. •Gather context

• •Run bash scripts/collect_context.sh to capture branch, issue key (from branch), staged files, and staged diff. If it exits because nothing is staged, stage the intended files first.
• •If the script is unavailable, collect manually: branch (git rev-parse --abbrev-ref HEAD), issue key (echo "$branch" | grep -oE '[A-Za-z]+-[0-9]+' | head -n1), staged files (git diff --cached --name-status), and staged diff (git diff --cached).

1. •Generate the message

• •Drop the collected context into references/prompt.md.
• •Keep the subject ≤ 72 chars, emoji-first, imperative; include the issue key when present.
• •Add bullets only when they add clarity; keep them short.

1. •Present and act

• •Show the proposed commit message.
• •Only commit if the user asks (git commit -m "message" or git commit -e -m "message"); default is to return the message.

Resources

• •scripts/collect_context.sh: emits branch, issue key, staged files, and diff; exits non-zero when nothing is staged.
• •references/prompt.md: ready-to-use prompt with emoji guide and sample formatting.

Packaging (for distribution)

• •Validate: python /Users/vicc/.codex/skills/.system/skill-creator/scripts/quick_validate.py skills/public/smart-commit
• •Package: python /Users/vicc/.codex/skills/.system/skill-creator/scripts/package_skill.py skills/public/smart-commit ./dist