Committing code

Skill alexei-led/cc-thingz/dist/claude/dev-flow/skills/committing-code

Portable skills, agents, hooks, and Pi extensions for Claude Code, Codex CLI, Copilot, Cursor, Grok, and Pi.

Install

npx -y skills add alexei-led/cc-thingz --skill committing-code

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

SKILL.md

2.7 KB, as published. Nobody here has run it

Commit Changes

Scope: inspect changes, group them, and create normal commits only. Do not rewrite history, amend existing commits, force-push, or stage secrets. Ground the proposal in git status, diff, and recent log output.

Step 1: Gather State

Use scripts/commit-state.sh gather if present; otherwise gather status, diff stat, and recent commits.

The helper is read-only. Treat helper output as a hint, not proof.

If grouping is unclear, inspect the full diff.

If no changes: say "Nothing to commit" and stop.
If not a git repository: report "Not a git repository" and stop.
If detached HEAD or rebase/merge is interrupted: report the git state verbatim and stop.

Step 2: Choose Fast Path or Split Path

Use the fast path when all are true:

few changed files
small diff stat
one coherent purpose from gathered output
no suspicious paths
no obvious mix of code, docs, tests, CI, or config for different purposes

Then propose one commit. No deep exploration. No invented split.

If mixed or unclear, inspect the full diff and group by purpose: feature, fix, refactor, docs, config. Use diff evidence, not filenames alone.

Match commit style from recent history.

Step 3: Present Proposed Commits

Proposed commits:

1. feat: add user validation
   - src/validate.ts
   - src/validate_test.ts

2. docs: update README
   - README.md

If the user rejects the grouping, ask for revised grouping and do not proceed until approved.

Step 4: Execute

Never stage likely secrets: .env, keys, certificates, credentials, passwords, tokens, or files that appear to contain secrets. Flag them to the user if detected in changes. This check does not replace secret-scanning tools.

Pause for user approval before any git add or git commit. For one focused commit, one approval gate is enough. For multiple commits, pause before each commit.

If a pre-commit hook rejects, report the hook error verbatim. Do not retry with --no-verify.

Conditional References

conventions.md — read when the repo has no commit history to match, or when the user requests Conventional Commits format: type prefixes, scope rules, breaking-change notation, subject-line style.

Step 5: Summary

Show final status, created commits, and remaining uncommitted files.