pr

Creates GitHub pull requests with base branch detection and review handoff.

3|Updated Apr 11, 2026
One-click install
npx skills add https://github.com/bravros/bravros --skill pr-bravros
Or copy as Structured Prompt for Agentβ–Ό
Please help me install this Agent Skill.
Skill: pr
Source: https://github.com/bravros/bravros/tree/main/plugins/core/skills/pr
Command: npx skills add https://github.com/bravros/bravros --skill pr-bravros

SYSTEM DOCUMENTATION & REQUIREMENTS

πŸ’‘ This Skill includes references (resource) components.

What problem does it solve? Opening a pull request involves repetitive decisions β€” picking the right base branch, formatting the title, writing a structured body, and triggering review β€” that are easy to get wrong or forget. This Skill automates the entire PR creation flow against your team's branching policy and guarantees the review handoff actually happens. ## Core Features & Use Cases - Base Branch Detection: Automatically targets homolog when it exists (enforcing the feature/* β†’ homolog β†’ main flow) and falls back to main, rebasing with --force-with-lease when behind. - Structured PR Body: Writes the body to a file with Summary, Changes, Technical Notes, Test Plan, and References sections, then strips any AI-attribution footer before calling gh pr create. - Mandatory Review Handoff: Finishes by invoking the pr-review skill interactively or emitting a STATUS: pr-created line in autonomous pipelines, so a created PR never sits unreviewed. - Use Case: After committing a feature branch, run the skill to open a correctly-targeted, properly formatted PR and immediately kick off code review without any manual gh commands. ## Quick Start Ask the agent to create a pull request for the current branch using the pr skill after all changes are committed.

Frequently Asked Questions about pr

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

FAQPage Schema
How do I create a GitHub pull request with the correct base branch?β–Ό

The skill detects the base branch automatically: it targets homolog when that branch exists locally or on origin, and falls back to main otherwise. If your branch is behind the base, it rebases and pushes with --force-with-lease before opening the PR.

How to write a structured pull request body with gh CLI?β–Ό

Write the body to a file with the Write tool containing Summary, Changes, Technical Notes, Test Plan, and References sections, then run gh pr create with --body-file as a separate command. Combining file creation and gh pr create in one command fails because the validation hook reads the file before the command runs.

Can a pull request target main directly in this workflow?β–Ό

No, PRs never target main directly under the enforced feature/* β†’ homolog β†’ main flow. Only a PR opened from the homolog branch itself targets main, and repositories without a homolog branch fall back to main as the base.

Why does gh pr create fail when using a heredoc for the body?β–Ό

The bravros police PreToolUse hook validates the body file before the command executes, so a heredoc or chained cat-and-create command means the file does not exist at validation time and gets blocked. Write the body file in a separate prior tool call instead.

Does the skill remove AI attribution from pull request bodies?β–Ό

Yes, it checks repo visibility with gh repo view and strips any AI-attribution footer such as Generated-with lines or Co-Authored-By trailers from the body file before creating the PR. On public repos such footers are treated as an information leak.

What happens after the pull request is created?β–Ό

The skill always hands off to review: interactively it invokes the pr-review skill immediately, and in autonomous mode it prints a STATUS line with the PR number so the pipeline triggers review. Creating the PR without the handoff is considered unfinished work.