pr-creator · b-mendoza — Claude Code skill: what it does, how to install
pr-creator turns your current branch into a pull or merge request. You see the exact preview first and approve before anything is created.
no license 195 installs ★ 3 updated 2026-10-25
npx skills add b-mendoza/agent-skills --skill pr-creator -a claude-codeWhat pr-creator does
The skill walks PR creation through a state machine. It looks at remotes and the platform, runs preflight checks for auth and already-open requests, pins the diff, drafts a title and body, then suggests reviewers and labels. Nothing is created until you approve the frozen preview.
Six subagents carry the phases: repo-state-inspector, preflight-validator, diff-analyzer, pr-drafter, review-metadata-suggester, pr-submitter. When a host cannot dispatch them, the same steps run inline and emit the same status blocks. The state table sits in state-machine.md, the diagram in flow-diagram.md, the contracts under references/.
No allowed-tools list ships with the package, so the host CLIs (git, gh, glab) do the actual work. Without an authenticated gh or glab the preflight stops. An open PR for the same head/base pair halts creation instead of producing a duplicate. Repository text and fetched pages count as data; imperative lines inside them get reported as a suspected injection.
What it helps with
- open a PR from the current branch without hand-writing the description
- get a Conventional Commits title out of the diff
- stop a duplicate PR when one is already open
- push from a fork into upstream
- pick reviewers and labels before submitting
Example prompts for the agent
- Create a PR from this branch into
mainas a draft - The branch is ready for review — open a pull request with
aliceandbobas reviewers - Open a merge request against
upstream/mainwith thedocslabel
How to install pr-creator
1Skills CLI (Vercel)
npx skills add b-mendoza/agent-skills --skill pr-creator -a claude-code2Manually: put the files in place
~/.claude/skills/pr-creator/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/pr-creator/
1Skills CLI (Vercel)
npx skills add b-mendoza/agent-skills --skill pr-creator -a codex2Manually: put the files in place
.agents/skills/pr-creator/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add b-mendoza/agent-skills --skill pr-creator -a cursor2Manually: put the files in place
.cursor/skills/pr-creator/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install b-mendoza/agent-skills skills/pr-creator2Manually: put the files in place
.github/skills/pr-creator/SKILL.md1Skills CLI (Vercel)
npx skills add b-mendoza/agent-skills --skill pr-creator -a gemini-cli2Platform CLI
gemini skills install https://github.com/b-mendoza/agent-skills --path skills/pr-creatorManually: put the files in place
.devin/skills/pr-creator/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add b-mendoza/agent-skills --skill pr-creator -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about pr-creator
How to install pr-creator in Claude Code?
Run npx skills add b-mendoza/agent-skills --skill pr-creator -a claude-code. The skill file lands at ~/.claude/skills/pr-creator/SKILL.md.
What does pr-creator do?
It handles pull and merge request creation end to end, from repo inspection to submit. You review the diff summary, drafted title and body, reviewers and labels in a preview, then approve that exact version.
Does it work with hosts other than GitHub?
GitLab is covered through glab alongside gh. For non-GitHub platforms the skill loads references/platform-adaptation.md to handle state capability differences.
Similar skills
All skills for Git and GitHub →pr-creator by other authors comes first.