create-pr

Create GitHub pull requests with verification and Codex review.

39|5|Updated Dec 28, 2025
One-click install
npx skills add https://github.com/benjaminshoemaker/ai_coding_project_base --skill create-pr-benjaminshoemaker
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: create-pr
Source: https://github.com/benjaminshoemaker/ai_coding_project_base/tree/main/.claude/skills/create-pr
Command: npx skills add https://github.com/benjaminshoemaker/ai_coding_project_base --skill create-pr-benjaminshoemaker

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill automates the process of creating a GitHub pull request by coordinating verification gates and Codex review, reducing manual steps and ensuring consistent PR quality.

Core Features & Use Cases

  • Pre-flight verification integration: Runs the project's verification gate (e.g., typecheck, lint, tests) via the optional .workstream/verify.sh before PR creation.
  • Auto-generated title and body: Generates a clean PR title and body from commits on the feature branch to ensure clarity and traceability.
  • Codex review integration: Runs Codex review (code or doc) and includes findings in the PR description; supports focus areas and skip options.
  • Workflow safety and gatekeeping: Checks branch state, base branch, and ensures you are on a feature branch with commits ahead.
  • Flexible invocation: Works with parameters like --base, --title, --draft, and --skip-verify/--skip-review to adjust PR behavior.

Quick Start

  • Ensure you are on a feature branch with committed changes.
  • Run /create-pr to initiate PR creation. Optional flags:
    • --base BRANCH to set a non-default base
    • --title "..." to override the generated title
    • --draft to create a draft PR
    • --skip-verify to bypass the verification gates
    • --skip-review to bypass Codex review

Frequently Asked Questions about create-pr

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

FAQPage Schema
How do I automate GitHub PR creation with verification checks and code review?

Automating GitHub PR creation involves running pre-merge verification gates and model-assisted reviews before opening a PR via the gh CLI. This skill coordinates those steps, auto-generating the PR title and body from commits while enforcing checks.

Can I create a draft PR and bypass the verification gate?

Yes, you can create a draft PR and bypass verification by using the --draft and --skip-verify flags. You can also override the auto-generated title with --title or set a non-default base branch with --base.

What is Codex review integration for pull requests?

Codex review integration is a model-assisted check that evaluates code or documentation changes before a PR opens. It runs automatically, includes findings in the PR description, and supports focus areas or skip options via the --skip-review flag.

How does auto-generating a PR title and body from commits work?

Auto-generating a PR title and body works by parsing commits on your feature branch ahead of the base. It extracts commit context to ensure clarity and traceability, building a standardized PR description without manual entry.

Do I need a specific script for pre-flight verification before opening a PR?

Pre-flight verification uses an optional .workstream/verify.sh script to run project checks like typecheck, lint, and tests. If absent, you can bypass this gate using the --skip-verify parameter during PR creation.

Why does automated PR creation check my branch state before opening?

Automated PR creation checks your branch state to ensure you are on a feature branch with commits ahead of the base. This workflow safety gatekeeping prevents invalid PRs and ensures standardized review processing.