| name | piv-commit |
| description | Creates a new git commit for all uncommitted changes with an atomic, conventionally-tagged message. Use when work is complete and ready to be committed. |
Commit: Create a New Commit
Create a new commit for all of our uncommitted changes.
Process
- Read this project's conventions. If
.claude/references/conventions.md exists, read its ## commit
section and follow it — those rules win over the defaults below. That file is where a project's specifics
live; this skill stays general.
- Run
git status && git diff HEAD && git status --porcelain to see what files are uncommitted.
- Add the untracked and changed files.
- Write an atomic commit message with an appropriate, descriptive summary.
- Add a tag such as
feat, fix, docs, refactor, test, chore, etc. that reflects our work.
Output
A single commit containing all uncommitted changes, with a conventional-commit-style message
(<tag>: <atomic description>) that accurately reflects the work done.
After the commit succeeds, print two clearly labelled summaries:
What Changed
One short paragraph (3–6 sentences) describing the feature/fix/refactor that was committed — what problem it solves and what files were the key touch points. Write for a developer skimming the git log.
AI Layer Changes
Only include this section if any files under .claude/ were modified or added (CLAUDE.md, .claude/references/, .claude/skills/, .claude/agents/, etc.).
List each changed AI-layer file with a one-line note on what evolved and why. If nothing in .claude/ changed, omit this section entirely.
