# create-pr

create-pr opens a GitHub pull request from the real branch diff: commits pending work first, runs the narrowest checks, pushes, then creates and verifies the PR with gh.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 156 installs · ★ 5 repo stars
- Author: ulpi-io
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/ulpi-io/skills/tree/HEAD/create-pr/SKILL.md
- Updated: 2026-08-31
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/ulpi-io-create-pr

## What it does

The skill builds a pull request from the full diff against the true base branch. Branch names and commit messages only hint at what happened. It looks at the current branch, its tracking state, uncommitted files and how far ahead of base you are. A dirty tree is not ignored: the `commit` skill runs first, then the workflow picks up again.

Readiness comes next. A branch sitting on `main`, `master` or `develop`, an empty branch, or conflict markers in changed files stop everything. Classification — type, scope, breaking changes — is read off the code, with `references/pr-conventions.md` loaded for the heuristics. Then the narrowest checks that fit the touched files run: typecheck, lint, a scan for conflict markers. Lint and type failures are warnings; conflict markers always block, and test status never gets invented in the body.

The branch is pushed before `gh pr create` runs, and afterwards the skill checks the number, URL, state, draft flag and base. No `gh` on the machine means no PR: you get a prepared title, body and compare URL to open it by hand. It stays user-only, so nothing fires until you ask for a PR, and it asks back when the base or reviewers are unclear.

## Requirements
- Works with: GitHub

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add ulpi-io/skills --skill create-pr -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/create-pr/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/create-pr/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add ulpi-io/skills --skill create-pr -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/create-pr/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add ulpi-io/skills --skill create-pr -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/create-pr/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install ulpi-io/skills create-pr
```

2. **Manually: put the files in place**
- File: `.github/skills/create-pr/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add ulpi-io/skills --skill create-pr -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/ulpi-io/skills --path create-pr
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/create-pr/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add ulpi-io/skills --skill create-pr -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/ulpi-io/skills/tree/HEAD/create-pr/SKILL.md

## When to use it
- open a PR that matches the diff rather than the branch name
- commit leftover changes before the PR is drafted
- catch conflict markers in changed files before pushing
- spell out breaking changes in the PR body
- confirm the new PR's number, URL and state right after creation

## Example prompts
- Open a draft PR against `main` and add the backend team as reviewers.
- Push this branch and create a pull request describing what actually changed.
- Make a PR for the current branch with a Conventional Commit title.

## Similar
- [gh](https://affpapa.org/en/nevibecode/skills/prathamdby-gh.md) — skill · 420 installs
- [github](https://affpapa.org/en/nevibecode/skills/ben-barclay-benbarclay-hermes-github.md) — skill · 245 installs
- [code-review](https://affpapa.org/en/nevibecode/commands/code-review.md) — command · 5537 installs
- [git-worktree-explorer](https://affpapa.org/en/nevibecode/plugins/git-worktree-explorer.md) — plugin · ★ 41430 repo stars
- [pr-create](https://affpapa.org/en/nevibecode/skills/pr-create.md) — skill · 807 installs
- [jackin-create-pr](https://affpapa.org/en/nevibecode/skills/jackin-create-pr.md) — skill · 469 installs

## Other versions with the same name
- [create-pr · neolabhq](https://affpapa.org/en/nevibecode/skills/create-pr.md) — 1200 installs
- [create-pr · zhaono1](https://affpapa.org/en/nevibecode/skills/zhaono1-create-pr.md) — 678 installs
- [create-pr · fradser](https://affpapa.org/en/nevibecode/skills/fradser-create-pr.md) — 109 installs
- [create-pr · yonatangross](https://affpapa.org/en/nevibecode/skills/orchestkit-create-pr.md) — 209 installs
- [create-pr · marcelorodrigo](https://affpapa.org/en/nevibecode/skills/marcelorodrigo-create-pr.md) — 312 installs

From the same set: [ulpi-io/skills](https://affpapa.org/en/nevibecode/by/ulpi-io/skills.md) — 49 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
