# create-pr

create-pr — a skill that creates a pull request with a Conventional Commits title, templated body, and local verification before submission.

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

## What it does

The skill runs typecheck, linter, tests and other checks locally, formats the PR title and body according to project conventions, optionally links a ticket from your issue tracker (Linear, Jira, GitHub Issues). It works with any language: commands are pulled from `Makefile`, `package.json`, `pyproject.toml`, `Cargo.toml` and other repo config files.

Workflow: analyze commits and diff, determine change type (`feat`, `fix`, `docs`, `refactor`, `test`, `chore`, `perf`, `ci`, `build`, `revert`) and scope, run checks for modified packages, build title and body, create PR with `gh pr create`.

For non-code changes (docs, markdown, config only) checks are skipped. If you modified a dependency manifest, the skill syncs the lockfile before submission — CI often fails when the lockfile is stale.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add Factory-AI/factory-plugins --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 Factory-AI/factory-plugins --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 Factory-AI/factory-plugins --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 Factory-AI/factory-plugins plugins/code-review/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 Factory-AI/factory-plugins --skill create-pr -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/Factory-AI/factory-plugins --path plugins/code-review/skills/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 Factory-AI/factory-plugins --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/Factory-AI/factory-plugins/tree/HEAD/plugins/code-review/skills/create-pr/SKILL.md

## When to use it
- Assemble and format a PR with a linked ticket
- Run typecheck, linter and tests for affected parts of the project
- Fill PR body from the repo template
- Sync lockfile after changing dependency manifest

## Example prompts
- Create a PR from the current branch
- Open a pull request linked to `TEAM-1234`
- Make a PR to `main`, run tests and linter before submission

## Similar
- [commit-pr](https://affpapa.org/en/nevibecode/skills/commit-pr-2.md) — skill · ★ 539 repo stars
- [task-to-pr](https://affpapa.org/en/nevibecode/skills/task-to-pr.md) — skill · 452 installs
- [write-pr](https://affpapa.org/en/nevibecode/skills/write-pr.md) — skill · 425 installs
- [verification-loop](https://affpapa.org/en/nevibecode/skills/verification-loop.md) — skill · 7200 installs
- [create-draft-pr](https://affpapa.org/en/nevibecode/skills/create-draft-pr.md) — skill · 107 installs
- [husky](https://affpapa.org/en/nevibecode/commands/husky.md) — command · 282 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: [factory-ai/factory-plugins](https://affpapa.org/en/nevibecode/by/factory-ai/factory-plugins.md) — 17 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
