pr-creator

Generate reviewer-ready GitHub pull request titles and bodies from git diffs.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Reviewers often lack the concise context, clear summary, and direct evidence they need to evaluate changes quickly; this Skill turns a branch and its diff into a PR that a reviewer can trust and act on within minutes.

Core Features & Use Cases

  • Reviewer-first PR writing: Produce a focused title and structured body (Summary, Context, Changes, Validation, Notes) that highlight what to read first and why it matters.
  • Safety and validation checks: Ensure the branch is pushed, identify the correct base branch, inspect diffs and commits, and verify the created PR with the gh CLI before reporting back.
  • AI attribution and transparency: Automatically include clear AI attribution in the PR body and commit trailers so reviewers know an agent participated.
  • Use Case: When a developer has a feature branch ready, use this Skill to draft the PR body, verify the diff, create the PR via gh, and return the PR URL.

Quick Start

Create a concise, reviewer-ready PR for the current branch that summarizes the change, explains the context, lists key changes, describes validation steps, and includes AI attribution.

Frequently Asked Questions about pr-creator

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

FAQPage Schema
How do I generate a GitHub pull request body from a git diff?

To generate a GitHub pull request body from a git diff, the Skill inspects branch commits and creates a structured summary with Context, Changes, and Validation sections. It then uses the gh CLI to open the PR and returns the URL.

Can I automatically add AI attribution to a pull request?

Yes, you can automatically add AI attribution to a pull request. The Skill includes clear AI attribution in both the PR body and commit trailers so reviewers know an agent participated in drafting the changes.

What is the best way to draft a reviewer-ready GitHub PR?

The best way to draft a reviewer-ready GitHub PR is to generate a focused title and structured body highlighting what to read first. This Skill formats diffs into Summary, Context, Changes, Validation, and Notes sections.

Does this PR creator require a pushed branch to work?

Yes, this PR creator requires a pushed branch to work. It performs safety and validation checks to ensure the branch is pushed, inspects the git diff, selects the correct base branch, and verifies the created PR using gh pr view.

How do I select the correct base branch when opening a GitHub PR?

To select the correct base branch when opening a GitHub PR, the Skill inspects the repository's branches and diffs. It identifies the appropriate base branch automatically before creating the pull request with the gh CLI.