Skip to main content
skill CX Codex

create-pr · fcakyon — Claude Code skill: what it does and how to install

The create-pr skill checks a branch, prepares a review-ready pull request, and publishes it with gh. Use it when you want an agent to handle the PR workflow for your changes.

Apache-2.0 ★ 1,216 updated 2026-11-09

Install into Claude Code · Plugin marketplace All methods and platforms ↓
/plugin marketplace add fcakyon/claude-codex-settings
/plugin install github-dev@claude-settings
Open on GitHub

What create-pr does

Before opening a PR, the skill reads repository guidance and checks Git status, staged work, the current branch, remote, and base. It keeps unrelated edits out of the change and avoids committing directly to main. For staged code changes it runs /simplify before committing; documentation-only diffs skip that step.

The skill reviews the full diff against the base, runs relevant checks, and records their actual results. It writes the PR body to a temporary file outside the repository, then passes that file to gh with --body-file. After publishing, it reads back the title and body and checks formatting. A working remote and gh are needed; if fast-forwarding the local base fails, the workflow stops without discarding dirty work.

What it helps with

  • inspect the target base and branch changes before opening a PR
  • draft a PR summary that includes completed check results
  • publish a pull request with an explicit base branch
  • revise an existing PR while preserving its images and links

Example prompts for the agent

  • Create a pull request for this branch, review the diff, run relevant checks, and publish it.
  • Open a PR for these changes against main and verify the published title and body.
  • Update the existing PR description while keeping its images and related links.

How to install create-pr

1Plugin marketplace

/plugin marketplace add fcakyon/claude-codex-settings
/plugin install github-dev@claude-settings

This installs the whole github-dev plugin with all its skills

2Skills CLI (Vercel)

npx skills add fcakyon/claude-codex-settings --skill create-pr -a claude-code

3Manually: put the files in place

~/.claude/skills/create-pr/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/create-pr/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about create-pr

How do I install create-pr in Claude Code?

Run /plugin marketplace add fcakyon/claude-codex-settings, then /plugin install github-dev@claude-settings. You can also install it with npx skills add fcakyon/claude-codex-settings --skill create-pr -a claude-code.

What does the create-pr skill do?

It inspects the branch and diff, prepares a pull request description with verified check results, publishes the PR through gh, and reads the published content back for review.

What happens if the base branch cannot be fast-forwarded?

The workflow stops and leaves dirty work intact rather than resetting it.

Source text

SKILL.md · Apache-2.0
---
name: create-pr
description: This skill should be used when user asks to "create a PR", "make a pull request", "open PR for this branch", "submit changes as PR", "push and create PR", or explicitly invokes "create-pr".
---

# Create PR

Create a PR a reviewer can understand without reading the conversation. Use extra invocation
text and session findings to explain the problem, final behavior, and evidence. Follow the
user's requested format and the target repo's guidance.

These rules apply to pull requests. For problem-focused issue titles and structured
issue reports, use [create-issue](../create-issue/SKILL.md).

## Workflow

1. **Inspect the scope and base**
   - Read repository guidance and inspect `git status`, staged changes, and the current branch.
   - Honor staged-only requests. Never stage unrelated work or require a new commit when the
     branch already contains the requested changes.
   - Confirm the target remote and base branch. Before creating a branch from main/master,
     fetch that remote and fast-forward the local base with `git merge --ff-only <remote>/<base>`.
     Preserve dirty work and stop if fast-forwarding fails. Do not reset it away.
   - Create a short branch using the repo's naming convention. Never commit directly to main.

2. **Finish and inspect the change**
   - Run `/simplify` on the staged diff before committing and apply its findings, docs-only
     commits included. Follow `commit-staged` for any staged changes.
   - Update existing documentation only when the requested change makes it inaccurate.
   - Review `git diff <remote>/<base>...HEAD` across all commits. For an existing PR, use its
     actual base and head, or `gh pr diff <pr>` if this checkout is on another branch.
   - Run appropriate checks and collect their actual results. Verify session findings against
     the final change, including links, counts, errors, and benchmark provenance.

3. **Write and publish**
   - Use the title and body guidance below. If a PR already exists, use `update-pr-summary`
     rather than opening a duplicate.
   - Write the exact body to a temporary file outside the repo and pass `--body-file` to `gh`.
     Never interpolate text into a shell command or include command output by accident.
   - Push the branch and create with an explicit base, `--title`, `--body-file`, and `-a @me`.
   - Add a reviewer only if explicitly requested or recent PRs by this author have reviewers:
     `gh pr list --repo <owner>/<repo> --author @me --limit 5 --json reviewRequests`.
   - Read back the published title and body with `gh pr view <pr> --json title,body,url`.
     Check code fences, tables, links, and preserved media. For visual changes, open the PR
     and verify the images render. Report the URL and any incomplete verification.

## Title and body

- PR title: start with a capitalized verb and name the concrete behavior, such as
  `Fix copied session text losing line breaks`. No internal brand names or vague claims.
  Add a Conventional Commits prefix (`fix: ...`) only when the repo squash-merges, since
  the title becomes the single commit, and match its recent merged titles. Otherwise use
  no type prefix. Rewrite the title and body when the final scope changes.
- Lead with the trigger and consequence: when does the bug happen, what goes wrong, and why
  does the fix matter? For a feature, show what the user can now do. Skip "This PR" openers.
- Keep distinct points in short bullets, usually 1-3. Do not squeeze several ideas into a
  paragraph or cut useful evidence to satisfy a word count. Small changes may need only
  one sentence and a snippet. Use short sections when reproduction, fix, and results need
  separation. Omit empty or boilerplate sections.
- For bugs, include the smallest useful reproduction, the actual error/output and expected
  behavior, then explain how the final change fixes it. Use exact logs where they show the
  failure. Skip setup noise, raw tool output, and the debugging diary.
- Show behavior with a copyable usage/reproduction snippet, a compact Before/After table,
  or separately labeled fenced Before and After outputs. Prefer these to red/green diff
  lines that force the reviewer to infer the outcome. Do not force snippets onto copy edits.
- Put measurements and main-versus-branch comparisons in a small table. State the dataset,
  workload, or sample count needed to interpret them. Link relevant issues, commits, docs,
  and result artifacts where they support the claim, rather than listing changed files.
- Include concise **completed validation**: the relevant command or check, its result, and
  material limitations or pre-existing failures. A future test checklist is not evidence.
  Do not claim full-run success from a focused check, or understate verified full runs.
- Include only implementation detail that explains the fix or a tradeoff. Mention net line
  counts or base-branch noise when they help distinguish the actual review scope.
- Never add AI attribution, session links, redundant captions, or a concluding sales pitch.

## Visual evidence and existing content

- UI/design changes need readable Before/After images or GIFs in a two-column table. Match
  viewport and scenario, and inspect the visuals before using them. Analysis/plot changes
  need representative outputs and measured results readable at the displayed size.
- Never commit PR screenshots or generated figures into the branch. Follow the user's and
  repo's hosting rules. Where release uploads are permitted, use an existing appropriate
  release and embed its asset URLs. Preserve existing GitHub attachment URLs as well.
- For Ultralytics repos, never upload visuals to release assets. Give the user absolute local
  paths, the PR link, and the sentence/table cell where each image belongs for manual upload.
  Do not invent attachment URLs or claim pending uploads are visible.
- When editing a body, preserve user-uploaded images/GIFs, bot-added context, related links,
  and still-valid evidence unless the user asks to remove them. Edit the relevant portion
  rather than replacing the whole body. Keep proof in the body instead of duplicating it
  in a separate comment.

## Example: bug with completed checks

````markdown
Copying a multiline command into a session loses its line breaks.

| Before | After |
|---|---|
| Pasted command becomes one line | Original line breaks survive |

- Preserve clipboard newlines at paste time
- Reuse the existing text insertion path

**Reproduce**
```sh
printf 'first\nsecond\n' | pbcopy
# Paste into an open session.
```

**Checked:** paste regression passes for multiline and single-line commands.
````

Adapt this shape to the evidence. For UI changes, comparison cells should carry the actual
screenshots/GIFs. For long outputs, use separate fenced blocks outside the table.

© Fatih C. Akyon · Apache-2.0 · fcakyon/claude-codex-settings

Similar skills

All skills for Git and GitHub →

create-pr by other authors comes first.

create-pr NeoLabHQ create-pr opens draft pull requests through the GitHub CLI using repository templates. It checks for uncommitted changes and formats PR titles with emojis. CX Codex +1 1,200installs create-pr zhaono1 create-pr — a skill that walks the agent through opening a pull request and keeps the English and Chinese READMEs in sync. Useful when the skill catalog changes and the docs have to follow. CX Codex +1 678installs create-pr FradSer The create-pr skill opens GitHub pull requests after quality and security checks, then hands them to CI monitoring and reviewer-comment triage. CX Codex +1 109installs create-pr OrchestKit create-pr — a skill that opens a GitHub pull request after running tests, linter, types, and security checks. Triggers on explicit invocation; plain gh pr create stays a command. CX Codex +1 209installs create-pr marcelorodrigo create-pr prepares structured pull requests, generates conventional titles, and submits them via GitHub CLI. CX Codex +1 312installs antfu-create-pr Anthony Fu antfu-create-pr is a Claude Code skill that creates a GitHub pull request with a Conventional Commits title, evidence, and UI screenshots. It runs when a PR is requested. CX Codex +1 919installs pr-create Garrick Aden-Buie (@gadenbuie) pr-create is a Claude Code skill that branches, commits changes, opens a GitHub PR, and monitors CI, pushing fixes until checks pass. CX Codex +1 807installs jackin-create-pr jackin-project jackin-create-pr opens a pull request for a small change in the jackin❯ repo: a typo, a dependency bump, a one-line bugfix. The PR body comes from the repo template with verify-locally blocks picked from the diff. CX Codex +1 469installs create-pull-request davila7 create-pull-request — a Claude Code command that opens a pull request via GitHub CLI against the project's own PR template. It fires when a branch is ready and you need a draft PR with all template sections filled in. CX Codex +1 411installs create-worktrees davila7 create-worktrees — a command for Claude Code fetches all open PRs through GitHub CLI and creates a git worktree for each branch in ./tree/<BRANCH_NAME>. Multiple PRs can be reviewed or worked on in parallel, each in its own directory. CX Codex +1 351installs devkit.github.create-pr Giuseppe Trisciuoglio devkit.github.create-pr — a Claude Code command that creates a branch, commits changes following Conventional Commits, and opens a GitHub pull request with a structured description. CX Codex +1 ★ 372repo stars

From the same set113

The whole set →
supabase-cli Equips coding agents to run Supabase CLI commands for local environments, schema migrations, edge function deployments, and TypeScript type generation. CX Codex +1 ★ 1,216repo stars payment-testing The payment-testing rule explains local checks for login, Stripe events, subscription renewals, refunds, and the backoffice. Use it when a payment flow behaves differently in your local stack. CX Codex +1 ★ 1,216repo stars troubleshooting troubleshooting — a rule covering common failures in a Dockerized Polar dev stack, from stuck ports to stale database connections. CX Codex +1 ★ 1,216repo stars supabase-js Adds practical cheat sheets and patterns for @supabase/supabase-js to your AI coding agent, covering Auth, Storage, Edge Functions, and queries. CX Codex +1 ★ 1,216repo stars electron Drives Electron desktop apps like Slack, VS Code, Discord, Figma and Spotify over the Chrome DevTools Protocol. CX Codex +1 ★ 1,216repo stars pull The pull command syncs local configuration, database schema, and Edge Functions with a linked Supabase project. Use it to refresh them in one run. CX Codex +1 ★ 1,216repo stars hetzner-deploy hetzner-deploy — a skill for managing Hetzner Cloud infrastructure via the hcloud CLI: servers, networks, firewalls, load balancers, DNS zones, and volumes. CX Codex +1 ★ 1,216repo stars ui-regression ui-regression verifies web apps and browser extensions on localhost, staging, or production across user flows, recovery states, locales, and viewports. CX Codex +1 ★ 1,216repo stars

Project sponsors

Companies that keep this analytics open