# create-draft-pr

create-draft-pr is a Claude Code skill that commits changes, pushes a branch, and creates a draft PR with a structured description and optional UX context.

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

## What it does

The skill runs the complete PR cycle in one action. It checks staged changes via `git status` and `git diff`, examines commit history style, creates a branch (if you're on `main`) following the project convention, commits and pushes with the `-u` flag, then generates a PR description using the `pr-description` format. When the change affects user-facing behaviour, workflow, or architecture, it includes a concise UX Flow section.

The description is structured: a one-line summary, a Problem section with specifics, a Solution section with approach and code where relevant. UX Flow appears only for product-oriented or architectural changes—mechanical fixes or dependency bumps skip it. The skill uses HEREDOC to preserve formatting and creates a draft PR via `gh pr create --draft`.

After PR creation, it switches back to `main` if that's where you started. PR titles stay concise (no "feat:" prefix, but "fix:" is fine for bug fixes). The description omits test checklists, file-by-file summaries, or attribution footers.

## Install

### Claude Code (native platform)

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

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

### Codex

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

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

### Cursor

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

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install jnsahaj/skills skills/create-draft-pr
```

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

### Gemini CLI

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

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

### Windsurf (Devin Desktop)

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

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add jnsahaj/skills --skill create-draft-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/jnsahaj/skills/tree/HEAD/skills/create-draft-pr/SKILL.md

## When to use it
- automate commit, push, and PR creation in one step
- standardize PR description format across the team
- include UX context for changes affecting user workflows
- create a draft PR without merging to the main branch
- follow the project's branch naming convention automatically

## Example prompts
- Create a draft PR for this change explaining the architecture shift
- Commit, push, and open a draft PR with the generated description
- Make a PR with UX flow for the new signup flow

## Similar
- [github-workflow](https://affpapa.org/en/nevibecode/skills/transilienceai-github-workflow.md) — skill · 195 installs
- [create-pr](https://affpapa.org/en/nevibecode/skills/orchestkit-create-pr.md) — skill · 209 installs
- [flow](https://affpapa.org/en/nevibecode/commands/flow.md) — command · ★ 730 repo stars
- [om-auto-create-pr](https://affpapa.org/en/nevibecode/skills/om-auto-create-pr.md) — skill · 4700 installs
- [coco-ship](https://affpapa.org/en/nevibecode/skills/coco-ship.md) — skill · ★ 328 repo stars
- [issue-create](https://affpapa.org/en/nevibecode/skills/issue-create.md) — skill · ★ 92149 repo stars

From the same set: [jnsahaj/skills](https://affpapa.org/en/nevibecode/by/jnsahaj/skills.md) — 6 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
