commit - SKILL.md Agent Skill

name: commit description: Preparing and creating git commits when explicitly requested; covers staged diff review, secrets checks, and conventional commit messages. condition: User explicitly asks to commit, ship, wrap up with a commit, or create a commit message.

Only use this skill when the user explicitly requests a commit or commit message.

Inspect current git status and diff before staging or committing.
Do not revert, stash, or overwrite unexpected user changes.
Check staged and unstaged diffs for secrets, credentials, tokens, private keys, and plaintext secret material.
Stage only files relevant to the requested change.
Generate a concise conventional commit message from the staged diff.
Commit only after verification has run, concrete prior verification evidence is recorded honestly, or the user explicitly accepts the remaining risk.

Use conventional commit format on the first line: type(scope): summary.
Prefer fix, feat, refactor, docs, test, chore, or ci.
Keep the subject line 50 characters or fewer.
Summary should describe user-visible or maintainer-visible effect, not implementation trivia.
A commit body is allowed when it improves future archaeology.
Separate subject and body with one blank line.
Wrap non-blank body lines at 72 characters or fewer.
Use body paragraphs for why, risk, migration notes, or verification context that belongs in git history.

For follow-up work on an open PR, prefer creating a new commit and pushing normally so review history remains chronological.
Do not amend, rebase, squash, or force-push an existing PR branch unless the user explicitly asks to rewrite history.
If history rewriting is explicitly requested, use --force-with-lease, explain why it is needed, and never use plain --force.