woocommerce-git-draft-pr

Creates a draft GitHub pull request from the current branch following WooCommerce conventions.

10.5k|10.7k|Updated Aug 9, 2011
One-click install
npx skills add https://github.com/woocommerce/woocommerce --skill woocommerce-git-draft-pr
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: woocommerce-git-draft-pr
Source: https://github.com/woocommerce/woocommerce/tree/main/.ai/skills/woocommerce-git-draft-pr
Command: npx skills add https://github.com/woocommerce/woocommerce --skill woocommerce-git-draft-pr

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Writing a pull request that follows the WooCommerce repository's template, changelog, milestone, and release communication rules is repetitive and error-prone. This Skill automates the analysis of your branch and generates a compliant draft PR.

Core Features & Use Cases

  • Branch Analysis: Inspects commits, diff stats, uncommitted changes, and existing changelog files to determine change type, significance, and whether the change is plugin-affecting.
  • Template-Compliant PR Body: Fills in the repository's PULL_REQUEST_TEMPLATE.md section by section, including changelog checkboxes, milestone, and release communication decisions.
  • Preflight Validation: Stops early if you are on trunk, have no commits ahead of trunk, or have uncommitted changes.
  • Use Case: After finishing a bug fix on a feature branch, ask for a draft PR and get a pushed branch plus a ready-to-review GitHub draft PR with the correct title, base branch, and template sections filled in.

Quick Start

Create a draft PR for my current branch using the WooCommerce PR conventions.

Frequently Asked Questions about woocommerce-git-draft-pr

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a draft PR on GitHub from the command line?

Push your branch with git push -u origin, then run gh pr create --draft with a title, base branch, and body. This Skill automates that flow while filling in the WooCommerce PR template sections for you.

How to write a pull request title for WooCommerce?

Use a verb-first title under 70 characters, such as "Fix <what was broken>" or "Add <what>", with an optional area prefix like [Email Editor]. Avoid fix:/feat: prefixes and internal Linear ticket references.

What base branch does the WooCommerce draft PR use?

The base branch is a release/* branch if your branch was created from one, otherwise it defaults to trunk. The Skill determines this automatically during its analysis step.

Why does the draft PR creation stop before pushing?

Preflight checks halt the process if you are on trunk, have no commits ahead of trunk, or have uncommitted changes. Commit or stash your work and switch to a feature branch before retrying.

Does the WooCommerce PR template require a changelog entry?

Plugin-affecting changes need a changelog: either automatic creation with significance, type, and message, or a note that changelog files were created manually. Non-plugin changes like CI or tooling are marked as not requiring one.