push-pr-light

Push the current branch and create or merge a GitHub pull request.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/KMakayee/playbook --skill push-pr-light
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: push-pr-light
Source: https://github.com/KMakayee/playbook/tree/main/.claude/skills/push-pr-light
Command: npx skills add https://github.com/KMakayee/playbook --skill push-pr-light

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you push your current branch and get a pull request opened quickly, while preventing you from pushing when your branch is stale compared to the intended base branch.

Core Features & Use Cases

  • Staleness gate: Detects the base branch (argument, existing PR base, or repo default) and stops if your branch is behind it.
  • Auto push + PR creation: Pushes to the remote if needed, then creates a PR (or surfaces the existing PR) using GitHub CLI.
  • Light diff review and safe merging: Runs a brief safety/quality scan of the PR diff and merges with squash only when no issues are found.

Quick Start

Use push-pr-light on your current branch to open or update a PR against the default base branch: run /push-pr-light.

Frequently Asked Questions about push-pr-light

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I push a branch and open a GitHub pull request fast from the command line?

To push a branch and open a GitHub pull request fast, you can use a feature-branch workflow automation that pushes your current branch and uses gh CLI to create a PR automatically.

How do I stop stale branches from being merged into the base branch?

To stop stale branches from being merged, you need a staleness gate that validates your branch against the base branch and halts the push if your branch is behind it.

Can I automatically squash merge a GitHub pull request after a diff review?

Yes, you can automatically squash merge a GitHub pull request after a diff review by running a safety scan on the PR diff and merging only when no issues are found.

Do I need gh CLI installed to automate GitHub pull request creation?

Yes, you need gh CLI installed to automate GitHub pull request creation, along with git and origin remote access for PR discovery, diff inspection, and merging.

How does auto title filling work for lightweight GitHub pull requests?

Auto title filling for lightweight GitHub pull requests works by applying a commit-range-based heuristic that generates the PR title and description from your branch history.

What happens if I try to push a branch that is behind the default base branch?

If you try to push a branch that is behind the default base branch, the staleness gate detects the base branch and stops the push to prevent merging outdated code.