# push-pr

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.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 276 repo stars
- Author: Samarth Gupta
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/gupsammy/Claudest/tree/HEAD/plugins/claude-coding/skills/push-pr/SKILL.md
- Updated: 2026-10-29
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/push-pr

## What it 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.

## Install

### Claude Code (native platform)

1. **Plugin marketplace**
In the agent chat (not a shell):
```text
/plugin marketplace add gupsammy/Claudest
```
In the agent chat (not a shell):
```text
/plugin install claude-coding@Claudest
```
This installs the whole claude-coding plugin with all its skills

2. **Skills CLI (Vercel)**
```bash
npx skills add gupsammy/Claudest --skill push-pr -a claude-code
```

3. **Manually: put the files in place**
- File: `~/.claude/skills/push-pr/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/push-pr/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add gupsammy/Claudest --skill push-pr -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/push-pr/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add gupsammy/Claudest --skill push-pr -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/push-pr/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install gupsammy/Claudest plugins/claude-coding/skills/push-pr
```

2. **Manually: put the files in place**
- File: `.github/skills/push-pr/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add gupsammy/Claudest --skill push-pr -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/gupsammy/Claudest --path plugins/claude-coding/skills/push-pr
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/push-pr/SKILL.md` — The legacy .windsurf/skills/ path still works

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/gupsammy/Claudest/tree/HEAD/plugins/claude-coding/skills/push-pr/SKILL.md

## When to use it
- push the current branch to its remote
- open a PR against `main` or 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
- 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.

## Similar
- [ce-commit-push-pr](https://affpapa.org/en/nevibecode/skills/ce-commit-push-pr.md) — skill · 3600 installs
- [commit-push-pr](https://affpapa.org/en/nevibecode/skills/commit-push-pr.md) — skill · ★ 1636 repo stars
- [gh-stack](https://affpapa.org/en/nevibecode/skills/gh-stack.md) — skill · 21500 installs
- [GitHub SSH Setup for Students (Existing Repository, Clone & Push Ready)](https://affpapa.org/en/nevibecode/prompts/github-ssh-setup-for-students-existing-repository-clone-push-ready.md) — prompt · ★ 178201 repo stars
- [pr-writer](https://affpapa.org/en/nevibecode/skills/pr-writer.md) — skill · 4700 installs
- [om-merge-buddy](https://affpapa.org/en/nevibecode/skills/om-merge-buddy.md) — skill · 3600 installs

From the same set: [gupsammy/claudest](https://affpapa.org/en/nevibecode/by/gupsammy/claudest.md) — 47 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
