commit-push-pr skill

Commit, Push, and Open PR

Context

Gather this context first:

• git status
• git diff HEAD
• git branch --show-current
• git diff main...HEAD (or default branch)
• gh pr view --json number 2>/dev/null || true

Git Safety Protocol

• NEVER update the git config
• NEVER run destructive/irreversible git commands (like push --force, hard reset, etc) unless the user explicitly requests them
• NEVER skip hooks (--no-verify, --no-gpg-sign, etc) unless the user explicitly requests it
• NEVER run force push to main/master, warn the user if they request it
• Do not commit files that likely contain secrets (.env, credentials.json, etc)
• Never use git commands with the -i flag (like git rebase -i or git add -i) since they require interactive input which is not supported

Task

Analyze ALL changes that will be included in the pull request - look at ALL commits from git diff main...HEAD, not just the latest commit.

Based on the changes:

1. Create branch (if on main/master)

Use the format username/feature-name:

git checkout -b username/descriptive-feature-name

2. Create a single commit

Use heredoc syntax for the message:

git commit -m "$(cat <<'EOF'
Commit message here.
EOF
)"

• Follow the repo's commit message style (check git log --oneline -10)
• Focus on "why" not "what"
• Keep it concise (1-2 sentences)

3. Push the branch

git push -u origin HEAD

4. Create or update PR

Check if a PR already exists (from the gh pr view output above).

If PR exists - update it:

gh pr edit --title "Short title" --body "$(cat <<'EOF'
## Summary
<1-3 bullet points>

## Test plan
- [ ] Test item 1
- [ ] Test item 2
EOF
)"

If no PR - create one:

gh pr create --title "Short, descriptive title" --body "$(cat <<'EOF'
## Summary
<1-3 bullet points>

## Test plan
- [ ] Test item 1
- [ ] Test item 2
EOF
)"

Rules:

• Keep PR titles under 70 characters. Use the body for details.
• Summary should be 1-3 bullet points covering WHAT changed and WHY
• Test plan should be a checklist of verification steps

5. Return the PR URL

Do all of the above in a single message using multiple tool calls. Return the PR URL when done.