Git commit writer
Drafts a Conventional Commits message from a diff and a one-line intent. Use when the user asks for a commit message or to summarize a change before committing.
Draft a Conventional Commits message from the diff the user already has. Do not stage, commit, or push unless the user explicitly asks for that exact action after accepting the wording.
Steps
- Read the diff and status the user provided. If neither is present, ask for them. Do not invent files or ticket ids.
- Pick a type (
feat,fix,docs,refactor,test,chore, orperf) and a scope only when one module dominates the change. - Write an imperative subject of 50 characters or fewer, with no trailing period.
- Add a body only when the reason is not obvious. Wrap near 72 characters and explain why, not a file list.
- Validate the draft: one subject line, a blank line before any body, and no path the diff does not contain. Show the draft and wait.
Example
User: Write a commit for a diff that retries webhook deliveries after a 429.
Agent:
fix(webhooks): retry deliveries that receive a 429
The client dropped the first rate-limit response. Retry three
times with backoff and store the last status on the delivery.
Boundaries
Do not amend, rebase, or push. If the diff contains a credential, stop and tell the user to remove it before any commit.
Lint report
Score 100. 0 errors, 0 warnings, 0 notes.
skill-lint reported no errors, warnings, or notes.
See also
- repo-maintainer, the agent that bundles this skill
- PR review notes Dev tools
- Test gap finder Dev tools
- Diff risk scan Dev tools
- Changelog from commits Dev tools
- Dependency audit notes Dev tools
- Incident timeline Dev tools
- Migration checklist Dev tools
- AGENTS.md writer Dev tools
References
- Source path skills/dev-tools/git-commit-writer
- SKILL.md 1.5 KB
- Raw SKILL.md
- Download the skill folder
- Agent Skills specification