Agent skill

WooCommerce Draft PR Creator

by woocommerce in woocommerce/woocommerce

Opens a concise draft pull request for the current branch, working out change type, base branch, title and body from the commits and diff.

Custom licenceAuto-check passedDevelopment

Install WooCommerce Draft PR Creator

skills CLI
$ npx skills add woocommerce/woocommerce --skill woocommerce-git-draft-pr -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install woocommerce/woocommerce woocommerce-git-draft-pr --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/woocommerce/woocommerce.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.ai/skills/woocommerce-git-draft-pr .claude/skills/woocommerce-git-draft-pr && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
woocommerce-git-draft-pr
GitHub stars
11k
Token cost
~1.1k tokens
SKILL.md length
570 words
Files
1
Skills in repo
11
Repo updated
First seen
Licence
Custom licence

At a glance

Opens a concise draft pull request for the current branch, working out change type, base branch, title and body from the commits and diff.

  • Works in 5 steps: Preflight and Analyze → Gather Context → Generate PR Title + Body → …
  • Pushing a finished branch and opening a draft PR
  • SKILL.md covers Dynamic Context, Procedure and Constraints
  • Calls git and gh

What it does

The skill gathers context with shell commands: the current branch, commits ahead of `trunk`, a diff stat, uncommitted changes, existing changelog files and the PR template. It stops if you are on trunk, if no commits are ahead or if the working tree has uncommitted changes. The base branch is a `release/*` branch when the work started from one and `trunk` otherwise.

It then classifies the change as Fix, Add, Update, Dev, Tweak, Performance or Enhancement, rates its significance as patch, minor or major, and checks for issue references, UI changes and whether the code ships to plugin users, which drives milestone and changelog handling. Titles are verb-first and under 70 characters, with no `fix:` or `feat:` prefixes and no Linear ticket references, because the repository's PRs are public.

When your agent uses it

  • Pushing a finished branch and opening a draft PR
  • Writing a reviewer-friendly PR description from the commit history
  • Deciding whether a change needs a changelog entry and milestone

Example prompts

  • “Create a draft PR for this branch.”
  • “Push my branch and open a draft PR that closes the checkout bug.”
  • “Make a PR for the email editor margin fix and fill in the repository template.”

Requirements

  • A Git checkout of the WooCommerce repository with a `trunk` branch

Workflow steps

5 steps, taken from the step headings in SKILL.md.

  1. Preflight and Analyze
  2. Gather Context
  3. Generate PR Title + Body
  4. Preview
  5. Push and Create

What it can do on your machine

Read from SKILL.md and the folder at commit b41b964. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • git
    • gh

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use git and gh, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

WooCommerce Draft PR Creator loads about 1.1k tokens when it runs. Until then it costs about 48 tokens; SKILL.md has 570 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~48
When it runs · the whole SKILL.md, loaded when a task matches
~1.1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 570 words (~1,135 tokens).

“Create a concise, reviewer-friendly draft PR from the current branch.”

— opening of SKILL.md by woocommerce, Custom licence
name
woocommerce-git-draft-pr

Read the full SKILL.md on GitHub

Files

Just SKILL.md in .ai/skills/woocommerce-git-draft-pr of woocommerce/woocommerce.

Open the folder on GitHubat commit b41b964

Compare with similar skills

WooCommerce Draft PR Creator next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

WooCommerce Draft PR Creator compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
WooCommerce Draft PR Creator this skillwoocommerce/woocommerce11k—~1.1kAutomated safety check: PassCustom licence
ZCF Release AutomationUfoMiao/zcf6.1k—~3.4kAutomated safety check: PassMIT
Commit and PR Publishing for CodexZaxbyHub/opencode-swarm490—~1.6kAutomated safety check: PassMIT
Contributor-First PR MergeHKUDS/OpenHarness16k1 repos~847Automated safety check: PassMIT
Create Pull Requestcline/cline70k1 repos~1.6kAutomated safety check: PassApache-2.0
Release Bumpjamiepine/voicebox57k—~1.1kAutomated safety check: PassMIT

Similar skills

  • Automates a version release with changesets: analyzes code changes, writes a bilingual CHANGELOG, bumps the version and commits through a release branch and pull request.

    6.1k GitHub stars~3.4k tokensUpdated 1 mo ago
    DevelopmentAuto-check passed
  • Commit and PR Publishing for Codex

    ZaxbyHub/opencode-swarm

    Codex adapter for opencode-swarm that governs commits, pushes, draft PRs, PR body updates and CI closeout, deferring to the repo's canonical commit-pr protocol.

    490 GitHub stars~1.6k tokensUpdated today
    DevelopmentAuto-check passed
  • Merges external GitHub pull requests while keeping the original author credited, and fixes conflicts after the merge instead of rewriting the contribution.

    16k GitHub starsUsed in 1 repo~847 tokens
    DevelopmentAuto-check passed
  • Opens a GitHub pull request from your current branch with the gh CLI, after reviewing the commits and diff and gathering the details the PR needs.

    70k GitHub starsUsed in 1 repo~1.6k tokens
    DevelopmentAuto-check passed
  • Release Bump

    jamiepine/voicebox

    Ends a release cycle by moving the Unreleased changelog notes under a dated version heading, bumping version files with bumpversion and tagging the commit.

    57k GitHub stars~1.1k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Official

    Generate a clear, concise GitHub PR title and description from the diff between two local git branches, and save it to prDescription.md in the repo root.

    12k GitHub stars~838 tokensUpdated today
    DevelopmentAuto-check passed

More from woocommerce/woocommerce

All 11 skills in this repo
  • WooCommerce Code Review

    woocommerce/woocommerce

    Reviews WooCommerce code changes against the project's standards, flagging backend PHP architecture, naming, documentation, data integrity and testing violations.

    11k GitHub starsUsed in 3 repos~1.1k tokens
    Auto-check passed
  • WooCommerce Markdown Guidelines

    woocommerce/woocommerce

    Rules for writing and editing markdown in the WooCommerce repository, with the project's markdownlint settings for headings, lists and code blocks.

    11k GitHub starsUsed in 1 repo~1.7k tokens
    Auto-check passed
  • Sets up a local environment for the WooCommerce block email editor, with a watcher, Mailpit email capture and build and test commands for its PHP and JS packages.

    11k GitHub stars~893 tokensUpdated today
    Auto-check passed
  • WooCommerce Dev Cycle

    woocommerce/woocommerce

    Workflow for WooCommerce development: run PHP and JavaScript tests, lint and fix code style on the current branch, and follow guides for i18n and markdown.

    11k GitHub starsUsed in 3 repos~431 tokens
    Auto-check passed
  • WooCommerce Git Commit

    woocommerce/woocommerce

    Commits pending changes with short, verb-first messages that follow WooCommerce repository conventions, splitting commits only when changes are clearly unrelated.

    11k GitHub stars~1.2k tokensUpdated today
    Auto-check passed
  • Starts, stops, restarts, and troubleshoots the WooCommerce Core wp-env setup and its asset build watchers without re-reading the setup docs.

    11k GitHub stars~1.1k tokensUpdated today
    Auto-check passed

Categories

Questions about WooCommerce Draft PR Creator

What does WooCommerce Draft PR Creator do?

Opens a concise draft pull request for the current branch, working out change type, base branch, title and body from the commits and diff. The skill gathers context with shell commands: the current branch, commits ahead of `trunk`, a diff stat, uncommitted changes, existing changelog files and the PR template. It stops if you are on trunk, if no commits are ahead or if the working tree has uncommitted changes.

When should I use WooCommerce Draft PR Creator?

WooCommerce Draft PR Creator fits situations like: pushing a finished branch and opening a draft PR; writing a reviewer-friendly PR description from the commit history; deciding whether a change needs a changelog entry and milestone.

How do I install WooCommerce Draft PR Creator in Claude Code?

Run `npx skills add woocommerce/woocommerce --skill woocommerce-git-draft-pr -a claude-code`. Or copy the skill folder (.ai/skills/woocommerce-git-draft-pr in woocommerce/woocommerce) into .claude/skills/woocommerce-git-draft-pr in your project. Claude Code loads it when a task matches its description.

How do I install WooCommerce Draft PR Creator in Codex?

Run `npx skills add woocommerce/woocommerce --skill woocommerce-git-draft-pr -a codex`. Or copy the skill folder (.ai/skills/woocommerce-git-draft-pr in woocommerce/woocommerce) into .agents/skills/woocommerce-git-draft-pr in your project. Codex loads it when a task matches its description.

Can I use WooCommerce Draft PR Creator in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add woocommerce/woocommerce --skill woocommerce-git-draft-pr -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/woocommerce-git-draft-pr, .gemini/skills/woocommerce-git-draft-pr, .github/skills/woocommerce-git-draft-pr and .opencode/skills/woocommerce-git-draft-pr in your project.

What does WooCommerce Draft PR Creator need to run?

Going by SKILL.md and its folder, WooCommerce Draft PR Creator needs the command-line tools its instructions call (git and gh). Our summary lists: A Git checkout of the WooCommerce repository with a `trunk` branch.

Does WooCommerce Draft PR Creator access the network?

SKILL.md contains no URLs. Its commands use git and gh, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is WooCommerce Draft PR Creator safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does WooCommerce Draft PR Creator use?

WooCommerce Draft PR Creator has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.

How many tokens does WooCommerce Draft PR Creator use?

About 1.1k tokens (SKILL.md is roughly 4.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to WooCommerce Draft PR Creator?

Skills that share tags, products or a category with WooCommerce Draft PR Creator: ZCF Release Automation (UfoMiao/zcf, 6.1k stars), Commit and PR Publishing for Codex (ZaxbyHub/opencode-swarm, 490 stars), Contributor-First PR Merge (HKUDS/OpenHarness, 16k stars) and Create Pull Request (cline/cline, 70k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains WooCommerce Draft PR Creator?

woocommerce (a GitHub organization) maintains it in woocommerce/woocommerce, which has 10,540 GitHub stars. The repository holds 11 skills in this directory. The repository was last updated on October 8, 2026.

Source: woocommerce/woocommerce on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.