Agent skill

WooCommerce Email Editor Development

by woocommerce in woocommerce/woocommerce

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.

Custom licenceAuto-check passedBackend & APIs

Install WooCommerce Email Editor Development

skills CLI
$ npx skills add woocommerce/woocommerce --skill woocommerce-email-editor -a claude-code

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

GitHub CLI
$ gh skill install woocommerce/woocommerce woocommerce-email-editor --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-email-editor .claude/skills/woocommerce-email-editor && 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-email-editor
GitHub stars
11k
Token cost
~893 tokens
SKILL.md length
242 words
Files
1
Skills in repo
11
Repo updated
First seen
Licence
Custom licence

At a glance

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.

  • Works in 4 steps: Start WooCommerce wp-env → Start the watcher → Enable the block email editor feature → …
  • Setting up local development for the WooCommerce email editor
  • SKILL.md covers When to Use This Skill, Development Environment Setup, Email Testing with Mailpit and Key Paths, plus 3 more sections
  • Calls pnpm, docker and composer

What it does

The skill walks through starting WooCommerce under `wp-env` with pnpm, running the admin watcher that rebuilds JS and syncs the PHP email editor package, enabling the block email editor in the WooCommerce advanced features settings, and then editing transactional emails from the email settings tab. The site normally runs on a local port, and `wp-env info` shows the real URL if the default is taken.

For testing delivery it uses Mailpit as a local SMTP server started in Docker, with a `.wp-env.override.json` file that installs the WP Mail SMTP plugin, and a restart of wp-env with the update flag. Key paths cover the PHP package under `packages/php/email-editor/` and the JS package under `packages/js/email-editor/`; the JS package is rebuilt with a pnpm filter command, and PHP tests run from the PHP package folder.

When your agent uses it

  • Setting up local development for the WooCommerce email editor
  • Changing email templates or transactional emails
  • Testing that WooCommerce emails are actually sent and captured locally
  • Modifying the email editor PHP or JS package

Example prompts

  • “Get the WooCommerce email editor running locally with the watcher started.”
  • “Set up Mailpit so I can see the order emails WooCommerce sends in dev.”
  • “Rebuild the email editor JS package after my changes.”

Requirements

  • pnpm and wp-env for the WooCommerce monorepo
  • Docker for the Mailpit container

Workflow steps

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

  1. Start WooCommerce wp-env
  2. Start the watcher
  3. Enable the block email editor feature
  4. Edit transactional emails

What it can do on your machine

Read from SKILL.md and the folder at commit 3bb7a91. 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:

    • pnpm
    • docker
    • composer

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

  • Network

    No URLs in SKILL.md. Its commands use pnpm and docker, 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 Email Editor Development loads about 893 tokens when it runs. Until then it costs about 42 tokens; SKILL.md has 242 words of instructions outside code blocks.

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

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 242 words (~893 tokens).

“This skill provides guidance for developing the WooCommerce block email editor.”

— opening of SKILL.md by woocommerce, Custom licence
name
woocommerce-email-editor

Read the full SKILL.md on GitHub

Files

Just SKILL.md in .ai/skills/woocommerce-email-editor of woocommerce/woocommerce.

Open the folder on GitHubat commit 3bb7a91

Compare with similar skills

WooCommerce Email Editor Development 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 Email Editor Development compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
WooCommerce Email Editor Development this skillwoocommerce/woocommerce11k—~893Automated safety check: PassCustom licence
WordPress ProJeffallan/claude-skills12k—~1.6kAutomated safety check: PassMIT
Wordpressericrisco/rsc-harness174—~3kAutomated safety check: PassMIT
Form Testingaiskillstore/marketplace430—~2kAutomated safety check: NotesNone
Changelogduracelltomi/gtm4wp174—~2.2kAutomated safety check: PassGPL-2.0-or-later
Wordpresssickn33/agentic-awesome-skills47k2 repos~348Automated safety check: PassMIT

Similar skills

  • WordPress Pro

    Jeffallan/claude-skills

    Develops WordPress themes, plugins, Gutenberg blocks and WooCommerce features with nonce, escaping and capability checks, phpcs linting and caching tuned for speed.

    12k GitHub stars~1.6k tokensUpdated 6 days ago
    DevelopmentAuto-check passed
  • Wordpress

    ericrisco/rsc-harness

    A skill your agent uses when building or hardening WordPress sites or WooCommerce stores and treating WordPress as the product rather than just writing PHP — block themes with theme.json, plugins…

    174 GitHub stars~3k tokensUpdated 2 days ago
    Backend & APIsAuto-check passed
  • Form Testing

    aiskillstore/marketplace

    Test WordPress form submissions and email delivery. An agent skill from aiskillstore/marketplace.

    430 GitHub stars~2k tokensUpdated yesterday
    Backend & APIsAuto-check: notes
  • Changelog

    duracelltomi/gtm4wp

    How to write GTM4WP CHANGELOG.md / readme.txt entries. An agent skill from duracelltomi/gtm4wp.

    174 GitHub stars~2.2k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Wordpress

    sickn33/agentic-awesome-skills

    Complete WordPress development workflow covering theme development, plugin creation, WooCommerce integration, performance optimization, and security hardening.

    47k GitHub starsUsed in 2 repos~348 tokens
    SecurityAuto-check passed
  • Livewire Development

    coollabsio/coolify

    A skill your agent uses for any task or question involving Livewire.

    63k GitHub stars~964 tokensUpdated yesterday
    Backend & APIsAuto-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
  • 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
  • WooCommerce Draft PR Creator

    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.

    11k GitHub stars~1.1k 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

Questions about WooCommerce Email Editor Development

What does WooCommerce Email Editor Development do?

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. The skill walks through starting WooCommerce under `wp-env` with pnpm, running the admin watcher that rebuilds JS and syncs the PHP email editor package, enabling the block email editor in the WooCommerce advanced features settings, and then editing transactional emails from the email settings tab. The site normally runs on a local port, and `wp-env info` shows the real URL if the default is taken.

When should I use WooCommerce Email Editor Development?

WooCommerce Email Editor Development fits situations like: setting up local development for the WooCommerce email editor; changing email templates or transactional emails; testing that WooCommerce emails are actually sent and captured locally; modifying the email editor PHP or JS package.

How do I install WooCommerce Email Editor Development in Claude Code?

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

How do I install WooCommerce Email Editor Development in Codex?

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

Can I use WooCommerce Email Editor Development 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-email-editor -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-email-editor, .gemini/skills/woocommerce-email-editor, .github/skills/woocommerce-email-editor and .opencode/skills/woocommerce-email-editor in your project.

What does WooCommerce Email Editor Development need to run?

Going by SKILL.md and its folder, WooCommerce Email Editor Development needs the command-line tools its instructions call (pnpm, docker and composer). Our summary lists: pnpm and wp-env for the WooCommerce monorepo; Docker for the Mailpit container.

Does WooCommerce Email Editor Development access the network?

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

Is WooCommerce Email Editor Development 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 Email Editor Development use?

WooCommerce Email Editor Development 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 Email Editor Development use?

About 893 tokens (SKILL.md is roughly 3.6k 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 Email Editor Development?

Skills that share tags, products or a category with WooCommerce Email Editor Development: WordPress Pro (Jeffallan/claude-skills, 12k stars), Wordpress (ericrisco/rsc-harness, 174 stars), Form Testing (aiskillstore/marketplace, 430 stars) and Changelog (duracelltomi/gtm4wp, 174 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains WooCommerce Email Editor Development?

woocommerce (a GitHub organization) maintains it in woocommerce/woocommerce, which has 10,542 GitHub stars. The repository holds 11 skills in this directory. The repository was last updated on October 9, 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.