pr-ready

Creates GitHub pull requests via gh CLI after running verification and branch checks.

Updated Jul 3, 2026
One-click install
npx skills add https://github.com/alex-jordan547/agent-setup --skill pr-ready-alex-jordan547
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: pr-ready
Source: https://github.com/alex-jordan547/agent-setup/tree/main/archive/2026-09-10/pr-ready
Command: npx skills add https://github.com/alex-jordan547/agent-setup --skill pr-ready-alex-jordan547

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Manually preparing a pull request involves repetitive steps: running verification, checking branch state, reviewing diffs, and formatting a PR body. This Skill automates that entire sequence so a PR is created consistently every time. ## Core Features & Use Cases - Pre-flight Verification: Runs the /verify check first and stops immediately if anything fails, preventing broken code from reaching review. - Branch State Management: Confirms you are not on master/main, checks remote tracking, and pushes the branch with upstream tracking if needed. - Automated PR Creation: Analyzes commits and diffs against the target branch, then creates a titled, structured PR (Summary + Test plan) via the GitHub gh CLI. - Use Case: After finishing a feature branch, invoke the skill to verify the code, push the branch, and open a draft PR against master with an auto-generated summary in one step. ## Quick Start Ask the agent to prepare and create a pull request for the current branch, optionally passing a target branch, a --draft flag, or a custom title.

Frequently Asked Questions about pr-ready

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

FAQPage Schema
How do I create a GitHub pull request from the command line?

Use the gh CLI command gh pr create with --title and --body flags after pushing your branch. This skill automates that flow by verifying checks, pushing the branch, and generating the PR title and body from your commit history.

How to generate a pull request summary from git commits?

Run git log master..HEAD --oneline and git diff master...HEAD to review commits and changes, then condense them into bullet points. The skill performs this analysis automatically and formats the result into Summary and Test plan sections.

Can I create a draft pull request with gh CLI?

Yes, pass the --draft flag when invoking the skill and it forwards it to gh pr create. Draft PRs signal work-in-progress and block merging until marked ready for review.

What happens if verification fails before creating a PR?

The skill runs the /verify check first and stops immediately if any check fails, reporting the failure instead of creating the PR. This prevents unverified code from being submitted for review.

Why does gh pr create fail with no remote tracking branch?

The error occurs when the local branch was never pushed to the remote. The skill detects missing upstream tracking with git rev-parse and runs git push -u origin HEAD before creating the PR.