Create Pr Skill for Codex
> Create Git branches, commits, pushes, and GitHub pull requests for Next.js. Use when the user asks to create a branch, commit current changes, open a PR or draft PR, publish a pull request, or recover from gh pr create / PR template issues. Covers .github/pull_request_template.md, --body formatting, codex/ branch names, and Codex app git directives.
Install
one command, takes just this skill from the repositorynpx skills add https://github.com/vercel/next.js --skill create-prThe instruction itself
6 sections, as written by the authorCreate PR
Use this skill when turning local work into a GitHub pull request.
Fork PRs vs Branch PRs
Before writing a PR description, check whether this is a branch PR (the
branch lives in vercel/next.js) or a fork PR (an external contribution from
a fork). You may write full descriptions for branch PRs, but not for fork
PRs — inform the user, offer to review their description or provide technical
details, and give them the GitHub URL to create the PR themselves. See
"GitHub Pull Requests and Issues" in AGENTS.md for the full policy.
Workflow
- Inspect the current state before mutating Git:
git status --short
git branch --show-current
git diff -- <paths>
Stage only files that belong to the requested change. Preserve unrelated
user changes.
- Create or confirm the branch:
git switch -c codex/<short-topic>
Use the codex/ prefix unless the user asks for a different name. If a
.git/*lock or Operation not permitted error appears, rerun the same Git
command with sandbox escalation. Do not assume a branch namespace conflict
until checking refs with git branch --list, git show-ref, or
git for-each-ref.
- Validate and commit:
git add <paths>
git diff --cached --check
git commit -m "<concise message>"
Keep commit messages concise and do not add generated-tool or co-author
footers.
- Push the branch:
git push -u origin <branch>
- Create the PR as a draft unless the user explicitly asks otherwise:
gh pr create --draft --base canary --head <branch> --title "<title>" --body '<body>'
For this repo, prefer canary as the base branch. If GitHub network access
fails in the sandbox, rerun with escalation.
PR Body
Use this PR body format:
## Summary
<what changed and why>
## Verification
- `<command that passed>`
- Not run: `<command>` (`<reason>`)
<!-- NEXT_JS_LLM -->
The "what" should be explained from the end-user perspective or developer perspective. Only include implementation changes if they're not obvious from the diff.
A "why" should be included if the change isn't self-explanatory, or if the motivation is not clear from the diff.
Omitting the "why" should be used sparingly and only for small changes.
Do not include trivial verification commands that CI already covers (e.g. pnpm run build), but do include any manual verification steps. If the PR changes a test, you don't need to repeat the command to run that test. But if you used an existing test to validate some behavior didn't change, include that test.
Use --body with this filled content.
Recovery
- If a PR may already exist, check before creating a duplicate:
gh pr view --head <branch> --json url,isDraft,title
- If approval is denied for
gh pr create, report that the branch is pushed
but the PR was not created, and provide the exact corrected command.
- After successful Codex app Git actions, include the appropriate final-response
directives for branch creation, staging, committing, pushing, and PR creation.
Related Skills
$pr-status-triage- Analyze CI failures and PR review feedback after the PR exists.$gh-stack- Manage stacked branches and dependent pull requests.
Other skills for the same job
different authors, same section of the catalogue
Execute git commit with conventional commit message analysis, intelligent staging, and message generation. Use when user asks to commit changes, create a git commit, or mentions "/commit". Supports: (1) Auto-detecting type and scope from changes, (2) Generating conventional commit messages from diff, (3) Interactive commit with optional type/scope/description overrides, (4) Intelligent file staging for logical grouping
Comprehensive GitHub code review with AI-powered swarm coordination
Create high-quality git commits: review/stage intended changes, split into logical commits, and write clear commit messages (including Conventional Commits). Use when the user asks to commit, craft a commit message, stage changes, or split work into multiple commits.
Comprehensive truth scoring, code quality verification, and automatic rollback system with 0.95 accuracy threshold for ensuring high-quality agent outputs and codebase reliability.
GitHub CLI (gh) comprehensive reference for repositories, issues, pull requests, Actions, projects, releases, gists, codespaces, organizations, extensions, and all GitHub operations from the command line.
GitHub CLI - manage repositories, issues, pull requests, actions, releases, and more from the command line.
You are a code refactoring expert specializing in clean code principles, SOLID design patterns, and modern software engineering best practices. Analyze and refactor the provided code to improve its quality, maintainability, and performance.
You are a technical debt expert specializing in identifying, quantifying, and prioritizing technical debt in software projects. Analyze the codebase to uncover debt, assess its impact, and create acti
How to use it
Take vercel/create-pr from the repository into ~/.claude/skills for personal
use, or into .claude/skills inside a project.
The agent identifies a skill by the name field in its header. Two skills with the
same name cannot sit side by side — one of them will be ignored.