push-pr — Claude Code skill for creating pull requests
push-pr is a Claude Code skill that pushes a branch and creates or updates its GitHub pull request. For large or mixed changes, it can propose splitting them into stacked PRs.
no license ★ 276 updated 2026-10-29
/plugin marketplace add gupsammy/Claudest
/plugin install claude-coding@ClaudestWhat push-pr does
The skill syncs the remote, checks the working tree, and gets a branch ready to push. If there are uncommitted changes, it invokes the commit skill; when work is on main or master, it creates a feature branch. Git operations use git and gh.
Before opening a PR, it compares commits and the diff against the remote target branch. A large diff or several distinct scopes or commit types can prompt a proposal to split the work into stacked PRs; the user chooses whether to proceed. The format-pr-body.py script builds the PR description.
The workflow relies on configured git, gh, and access to the remote repository. If a rebase hits conflicts, the skill stops. Its diff-size threshold is a guideline for proposing a split, not a promise that every large change will be divided.
What it helps with
- push the current branch to its remote
- open a PR against
mainor another chosen base - update an existing PR with new commits
- split changes by scope or size into stacked PRs
- build a PR description from the diff
Example prompts for the agent
- Open a pull request for this branch against
main. - Push these changes as a draft PR targeting
develop. - Check whether these changes should become stacked PRs by scope.
How to install push-pr
1Plugin marketplace
/plugin marketplace add gupsammy/Claudest/plugin install claude-coding@ClaudestThis installs the whole claude-coding plugin with all its skills
2Skills CLI (Vercel)
npx skills add gupsammy/Claudest --skill push-pr -a claude-code3Manually: put the files in place
~/.claude/skills/push-pr/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/push-pr/
1Skills CLI (Vercel)
npx skills add gupsammy/Claudest --skill push-pr -a codex2Manually: put the files in place
.agents/skills/push-pr/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add gupsammy/Claudest --skill push-pr -a cursor2Manually: put the files in place
.cursor/skills/push-pr/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install gupsammy/Claudest plugins/claude-coding/skills/push-pr2Manually: put the files in place
.github/skills/push-pr/SKILL.md1Skills CLI (Vercel)
npx skills add gupsammy/Claudest --skill push-pr -a gemini-cli2Platform CLI
gemini skills install https://github.com/gupsammy/Claudest --path plugins/claude-coding/skills/push-prManually: put the files in place
.devin/skills/push-pr/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about push-pr
How do I install push-pr in Claude Code?
Add the marketplace with /plugin marketplace add gupsammy/Claudest, then install the plugin with /plugin install claude-coding@Claudest.
What does push-pr do?
It pushes the current branch, then creates or updates a pull request. For large or varied changes, it can offer a stack of related PRs.
What does push-pr need to run?
The workflow uses git and gh to manage branches and pull requests. It stops if a rebase encounters conflicts.