commit

Commit with Conventional Commits

Stage and commit current changes using the conventional commits format.

IMPORTANT: This skill MUST be used for ALL commits — even when the user says "commit" without /commit. Never commit without following these steps.

Current State

• Branch: !git branch --show-current
• Status: !git status --short
• Staged diff: !git diff --cached --stat 2>/dev/null
• Unstaged diff: !git diff --stat 2>/dev/null
• Recent commits: !git log --oneline -5 2>/dev/null

Arguments

• $ARGUMENTS - Optional hint for the commit message (e.g., fix the snapshot comparison)

Instructions

1. Review the state above — understand what changed and why.

2. Stage files — add only the relevant changed files by name. Never use git add -A or git add .. Never stage files that contain secrets (.env, credentials, etc.).

3. Determine the commit type from the nature of the changes:

   • feat — new feature or capability
   • fix — bug fix
   • docs — documentation only
   • style — formatting, whitespace (no logic change)
   • refactor — code restructuring (no behavior change)
   • test — adding or updating tests
   • chore — maintenance, tooling, config
   • perf — performance improvement

4. Determine the scope from the area of the codebase affected:

   • assert — assertions (src/assert*.sh)
   • runner — test runner
   • cli — CLI entry point, flags, options
   • doubles — mocks, spies
   • docs — documentation site
   • ci — CI/CD, GitHub Actions
   • Use the most specific scope that fits. Omit if changes span many areas.

5. Write the commit message:

   • Format: <type>(<scope>): <description>
   • Description: imperative mood, lowercase, no period, under 70 chars
   • Focus on why, not what
   • Add a body (separated by blank line) only if the why isn't obvious from the description
   • Never mention AI, Claude, or automation in the message

6. Create the commit:

   git commit -m "$(cat <<'EOF'
   <type>(<scope>): <description>
   
   <optional body>
   EOF
   )"