git
Git workflow commands for committing changes and managing pull requests. Use when the user says '/git commit', '/git commit-all', '/git pr', '/git pr-update', '/git pr-pull-review', or '/git help'. Supports atomic commits, conventional commit format, and PR creation/updates without AI attribution.
How do I install this agent skill?
npx skills add https://github.com/agoodway/goodskills --skill gitIs this agent skill safe to install?
- Gen Agent Trust Hubpass
This skill automates Git workflows, including commits and pull request management. It features a security-conscious 'commit-all' command that explicitly excludes sensitive files like environment variables and credentials. A minor security risk exists because the skill reads external PR review comments from GitHub, which could theoretically contain malicious instructions (indirect prompt injection); however, the skill mitigates this by requiring user confirmation before addressing any comments.
- Socketpass
No alerts
- Snykwarn
Risk: MEDIUM · 1 issue
What does this agent skill do?
Git Workflow Skill
This skill is runtime-neutral and works in Claude Code, OpenCode, and Codex. Use the current runtime's shell, read, edit/write, search, and question tools. Do not add any AI attribution footer for any runtime.
Runtime Notes
- Claude Code: use
AskUserQuestionfor choices when available. - OpenCode: use the question tool for choices when available.
- Codex: ask the user directly when interactive input is required.
- If an interactive git command would be required, avoid it and use non-interactive alternatives. Do not use
git add -punless the runtime can safely drive the interaction; otherwise stage explicit files or ask the user which files to include.
Atomic Commits
Before committing, review all changes and organize into logical units:
- Group related changes - Same feature, bug fix, or refactor belongs together
- Separate unrelated changes - Different fixes or features get separate commits
- Single responsibility - Each commit should be independently revertible
- Don't mix concerns - Keep formatting separate from logic changes
When changes span multiple concerns, stage specific files to create separate commits. Use partial staging only when the runtime supports it safely; otherwise ask the user how to split the changes.
Commands
/git (no subcommand)
When invoked without a subcommand, default to the commit workflow below.
/git help
Display a list of all available subcommands. Output the following exactly:
/git subcommands:
commit [message] — Commit staged/unstaged changes with conventional format
commit-all — Commit all changes as logical atomic commits, skipping junk files
pr [context] — Create a draft pull request for the current branch
pr-update — Push and update an existing PR description
pr-pull-review — Fetch PR review comments and address them
help — Show this help message
/git commit [message]
Commit changes without AI attribution.
- Run
git statusto see what needs to be committed (including untracked files) - Run
git diffto review the changes - Analyze changes for logical grouping - create multiple commits if changes are unrelated
- Stage related changes together:
- For specific files:
git add <file1> <file2> - For partial staging: use a runtime-supported non-interactive patch workflow, or ask the user how to split the changes
- Include any new/untracked files shown in git status
- For specific files:
- Create commit with conventional format:
type: description - DO NOT include AI attribution footer
- If user provided a message in $ARGUMENTS, use it as context for the commit
- After committing, ask user about pushing using the runtime's question mechanism
- If they push and aren't on main branch, ask if they want to open a PR
- If yes, use
gh pr create --draftwith appropriate title and description
/git commit-all
Commit all working tree changes as logical, atomic commits — but skip files that look unneeded.
- Run
git statusto see all staged, unstaged, and untracked changes - Filter out junk files — do NOT stage or commit any of the following:
- OS artifacts:
.DS_Store,Thumbs.db,Desktop.ini,._* - Editor/IDE files:
.idea/,.vscode/settings.json,*.swp,*.swo,*~ - Build artifacts:
_build/,deps/,node_modules/,dist/,*.beam - Temp/debug files:
*.log,*.tmp,*.bak,*.orig,dump.rdb - Secrets:
.env,.env.*(except.env.sample,.env.example),credentials.* - Any file already covered by
.gitignorepatterns - If unsure whether a file is needed, ask the user with the runtime's question mechanism
- OS artifacts:
- Run
git diffandgit diff --cachedto review all changes - Group changes into logical commits following the atomic commit rules:
- Analyze every changed file and determine which concern it belongs to
- Group by feature, fix, refactor, or area — each group becomes one commit
- Separate formatting/style changes from logic changes
- Migrations, schema changes, and their corresponding code go together
- Test files go with the code they test
- For each logical group (in dependency order — e.g., migrations before code that uses them):
- Stage only the files for that group:
git add <file1> <file2> ... - Commit with conventional format:
type: description - DO NOT include AI attribution footer
- Stage only the files for that group:
- After all commits, show a summary of what was committed (commit count, files, short log)
- Ask user about pushing using the runtime's question mechanism
- If they push and aren't on main branch, ask if they want to open a PR
/git pr [context]
Create a pull request for the current branch.
- Check
git statusfor uncommitted changes - If uncommitted changes exist:
- Run
git diffto review - Follow atomic commit rules - create multiple commits if needed
- Stage and commit with conventional format
- DO NOT include AI attribution
- Run
- Verify current branch and recent commits with
git log - Push any unpushed commits to remote
- Determine base branch (check
git remote show originfor default, fallback to 'main') - Create PR using
gh pr create --draftwith:- Clear title in conventional commit format
- Detailed body including:
- Summary section with bullet points
- Detailed changes organized by area
- Test plan with checklist items
- Breaking changes or migration notes if applicable
- DO NOT include AI attribution or generated-by footer
- If user provided context in $ARGUMENTS, use it for PR title/description
- Return the PR URL to the user
/git pr-update
Push current branch and update PR description.
- Verify we're in a git repository and get current branch name
- Check for uncommitted changes - alert user if any exist
- Push current branch to origin (use
-uflag if branch doesn't exist on remote) - Check if PR exists using
gh pr view - If PR exists:
- Get current PR number and details
- Analyze commits since PR creation with
git log - Generate updated description with:
- Summary of all changes
- List of commits included
- Test plan updates if relevant
- Update PR using
gh pr edit
- If no PR exists:
- Ask user if they want to create one
- If yes, analyze all commits since diverging from main/master
- Create comprehensive PR with
gh pr create --draft
- Show PR URL and summary of what was updated
/git pr-pull-review
Pull PR review comments and address them.
- Get the current branch name and find the associated PR:
- Run
gh pr view --json number,url,titleto get PR details - If no PR exists, tell the user and stop
- Run
- Fetch all review comments:
- Run
gh pr view --json reviews,commentsto get top-level PR comments - Run
gh api repos/{owner}/{repo}/pulls/{number}/commentsto get inline review comments (these are file-specific) - Filter to only unresolved and actionable comments — skip:
- Already-resolved comment threads
- Pure approvals or "LGTM" comments
- Bot comments (CI, linters, etc.)
- Run
- Present a numbered summary of each review comment to the user:
- For inline comments: show file, line, and the comment body
- For general comments: show the comment body
- Ask the user which comments to address (all, specific numbers, or skip any) using the runtime's question mechanism
- For each comment the user wants addressed:
- Read the referenced file to understand the context
- Implement the requested change
- If a comment is ambiguous or you disagree with the suggestion, ask the user with the runtime's question mechanism before making the change
- After all changes are made:
- Follow atomic commit rules — group related review fixes together
- Commit with format:
fix: address PR review — <brief summary> - DO NOT include AI attribution footer
- Reply to each addressed comment on the PR:
- Run
gh api repos/{owner}/{repo}/pulls/{number}/comments/{comment_id}/replies -f body="Addressed in <commit-sha>" - For top-level comments, use
gh pr comment --body "Addressed: <summary of what was fixed>"
- Run
- Push the changes and show a summary of what was addressed
Commit Message Format
type: concise description
Optional body for context
Types: feat, fix, chore, docs, refactor, test, style
Error Handling
If any errors occur:
- Clearly explain what went wrong
- Suggest fixes or alternatives
- Ask if user wants to retry or handle manually
$ARGUMENTS
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/agoodway/goodskills/git">View git on skillZs</a>