Skip to main content
skill CX Codex

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

Install into Claude Code · Plugin marketplace All methods and platforms ↓
/plugin marketplace add gupsammy/Claudest
/plugin install claude-coding@Claudest
Open on GitHub

What 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 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 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@Claudest

This installs the whole claude-coding plugin with all its skills

2Skills CLI (Vercel)

npx skills add gupsammy/Claudest --skill push-pr -a claude-code

3Manually: put the files in place

~/.claude/skills/push-pr/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/push-pr/

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.

Similar skills

All skills for Git and GitHub →

From the same set47

The whole set →
architecture-auditor architecture-auditor reviews system structure, detects circular dependencies, and suggests design patterns when features touch multiple modules. CX Codex ★ 276repo stars make-changelog make-changelog creates or updates CHANGELOG.md from Git history in Keep a Changelog format. Use it when preparing release notes or catching up on missing entries. CX Codex +1 ★ 276repo stars recall-conversations recall-conversations reads back your earlier Claude sessions: finds a decision, restores context, or builds a retro from the local conversation database. CX Codex +1 ★ 276repo stars make-readme make-readme inspects repository context, runs a brief questionnaire, and builds a complete README.md with status badges. CX Codex +1 ★ 276repo stars brainstorm brainstorm — an interview skill that turns the tables: the agent asks, you answer, and the session ends with a written spec or decision doc. CX Codex +1 ★ 276repo stars get-token-insights get-token-insights parses Claude Code conversation history, flags token waste, and generates an offline dashboard covering costs, hooks, and agent workflows. CX Codex +1 ★ 276repo stars extract-frames extract-frames detects shot boundaries in a video and saves the first or last frame of each shot. Use it to review an edit or collect frames from selected shots. CX Codex +1 ★ 276repo stars search-youtube search-youtube finds YouTube videos, pulls transcripts and metadata, downloads audio and walks a channel's uploads through a single CLI the agent calls on its own. CX Codex +1 ★ 276repo stars

Project sponsors

Companies that keep this analytics open