# woocommerce-git-draft-pr

woocommerce-git-draft-pr turns the current branch into a draft pull request: reads commits and diff, fills the repo template, pushes and opens the PR.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 119 installs · ★ 10608 repo stars
- Author: woocommerce
- License: GPL-2.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/woocommerce/woocommerce/tree/HEAD/.ai/skills/woocommerce-git-draft-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/woocommerce-git-draft-pr

## What it does

The skill looks at your branch, the commits ahead of `trunk`, diff stats and `.github/PULL_REQUEST_TEMPLATE.md`, then works through the template section by section. Titles stay under 70 characters and open with a verb like `Fix` or `Add`. Conventional-commit prefixes are not used.

Base branch is `release/*` when the work started there, `trunk` otherwise. Change type and significance come out of the diff, and the skill works out whether the code ships to users, because milestone and changelog choices follow from that. Changelog files already present in the diff get marked as written by hand.

A dirty working tree halts the run: the skill pushes but never commits. You see the proposed title and body first, then `git push -u origin` and `gh pr create --draft` run. Template headings and HTML comments are left untouched — repo automation reads those markers.

## Install

### Claude Code (native platform)

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

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

### Codex

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

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

### Cursor

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

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install woocommerce/woocommerce .ai/skills/woocommerce-git-draft-pr
```

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

### Gemini CLI

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

2. **Platform CLI**
```bash
gemini skills install https://github.com/woocommerce/woocommerce --path .ai/skills/woocommerce-git-draft-pr
```

### Windsurf (Devin Desktop)

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

### OpenCode

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

## When to use it
- open a draft PR from the current branch
- fill the repo PR template section by section
- classify the change for the changelog entry
- pick `release/*` as the base instead of `trunk`
- trace the PR that introduced a bug

## Example prompts
- Create a draft PR from this branch against `trunk`
- Push the branch and open a draft PR using the repo template
- Open the PR with no changelog entry, this change does not ship to users

## Similar
- [changelog-draft](https://affpapa.org/en/nevibecode/skills/changelog-draft.md) — skill · ★ 720 repo stars
- [git-workflow](https://affpapa.org/en/nevibecode/skills/jezweb-git-workflow.md) — skill · 1300 installs
- [git-worktree-explorer](https://affpapa.org/en/nevibecode/plugins/git-worktree-explorer.md) — plugin · ★ 41430 repo stars
- [create-draft-pr](https://affpapa.org/en/nevibecode/skills/create-draft-pr.md) — skill · 107 installs
- [git-merge-expert](https://affpapa.org/en/nevibecode/skills/git-merge-expert.md) — skill · 182 installs
- [git-flow-manager](https://affpapa.org/en/nevibecode/agents/git-flow-manager.md) — subagent · 3127 installs

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