| name | commit |
| description | Read this skill before making git commits and pushing |
Create a git commit for the current changes using a concise Conventional Commits-style subject.
Format
<type>(<scope>): <summary>
type REQUIRED. Use feat for new features, fix for bug fixes. Other common types: docs, refactor, chore, test, perf.
scope OPTIONAL. Short noun in parentheses for the affected area (e.g., api, parser, ui).
summary REQUIRED. Short, imperative, <= 72 chars, no trailing period.
Notes
- Body is OPTIONAL. If needed, add a blank line after the subject and write short paragraphs.
- Do NOT include breaking-change markers or footers.
- Do NOT add sign-offs (no
Signed-off-by).
- After committing, push to the current branch. Never push to
main/the default branch — if you are on it (and the repo's AGENTS.md/CLAUDE.md doesn't forbid branching), create a feature branch (<github-username>/<feature-name>) first, then push with -u.
- Skip files containing secrets (
.env, credentials, tokens) and warn if any are staged. Skip .agents/settings.local.json / .claude/settings.local.json — add them to .gitignore if not already ignored.
- If it is unclear whether a file should be included, ask the user which files to commit.
- Treat any caller-provided arguments as additional commit guidance. Common patterns:
- Freeform instructions should influence scope, summary, and body.
- File paths or globs should limit which files to commit. If files are specified, only stage/commit those unless the user explicitly asks otherwise.
- If arguments combine files and instructions, honor both.
Steps
- Infer from the prompt if the user provided specific file paths/globs and/or additional instructions.
- Review
git status and git diff to understand the current changes (limit to argument-specified files if provided).
- (Optional) Run
git log -n 50 --pretty=format:%s to see commonly used scopes.
- If there are ambiguous extra files, ask the user for clarification before committing.
- Check the current branch. If it is
main/the default branch (and the repo's AGENTS.md/CLAUDE.md doesn't forbid branching), create a feature branch (<github-username>/<feature-name>) first.
- Stage only the intended files by name (all changes if no files specified). Do not blindly
git add -A — exclude secrets and *.local.json.
- Run
git commit -m "<subject>" (and -m "<body>" if needed).
- Push the current branch with
git push -u origin HEAD.