Create high-quality git commits: review/stage intended changes, split into logical commits, and write clear commit messages (including Conventional Commits). Use when the user asks to commit, craft a commit message, stage changes, or split work into multiple commits.
NewUpdated Apr 20, 2026
Commit work
Goal
Make commits that are easy to review and safe to ship:
only intended changes are included
commits are logically scoped (split when needed)
commit messages describe what changed and why
Inputs to ask for (if missing)
Single commit or multiple commits? (If unsure: default to multiple small commits when there are unrelated changes.)
Commit style: Conventional Commits are required.
Any rules: max subject length, required scopes.
Workflow (checklist)
Inspect the working tree before staging
git status
git diff (unstaged)
If many changes: git diff --stat
Decide commit boundaries (split if needed)
Split by: feature vs refactor, backend vs frontend, formatting vs logic, tests vs prod code, dependency bumps vs behavior changes.
If changes are mixed in one file, plan to use patch staging.
Stage only what belongs in the next commit
Prefer patch staging for mixed changes: git add -p
To unstage a hunk/file: git restore --staged -p or git restore --staged <path>
Review what will actually be committed
git diff --cached
Sanity checks:
no secrets or tokens
no accidental debug logging
no unrelated formatting churn
Describe the staged change in 1-2 sentences (before writing the message)
"What changed?" + "Why?"
If you cannot describe it cleanly, the commit is probably too big or mixed; go back to step 2.
Write the commit message
Use Conventional Commits (required):
type(scope): short summary
blank line
body (what/why, not implementation diary)
footer (BREAKING CHANGE) if needed
Prefer an editor for multi-line messages: git commit -v
Use references/commit-message-template.md if helpful.
Run the smallest relevant verification
Run the repo's fastest meaningful check (unit tests, lint, or build) before moving on.
Repeat for the next commit until the working tree is clean
Deliverable
Provide:
the final commit message(s)
a short summary per commit (what/why)
the commands used to stage/review (at minimum: git diff --cached, plus any tests run)
Files3
3 files · 6.2 KB
Select a file to preview
Overall Score
87/100
Grade
A
Excellent
Grades are signals, not a certification. Always review a skill yourself before use.
Safety
90
Quality
88
Clarity
87
Completeness
82
Summary
A skill for creating high-quality git commits with intentional staging, logical scoping, and Conventional Commits formatting. It guides agents through a structured 8-step workflow: inspect changes, decide commit boundaries, stage selectively using patch mode, review staged changes, write descriptive messages, verify with tests, and repeat until the working tree is clean.
Detected Capabilities
Git status inspection and diff analysisSelective file and patch stagingCommit message composition following Conventional CommitsWorking tree boundary decision logicSafety verification (secrets, debug code detection guidance)Test/verification execution coordination
Trigger Keywords
Phrases that agents use to match this skill to user intent.
commit workstage changessplit commitsconventional commitscommit messagereview before commitpatch staging