Agent skill

WooCommerce Local Environment Runner

by woocommerce in woocommerce/woocommerce

Starts, stops, restarts, and troubleshoots the WooCommerce Core wp-env setup and its asset build watchers without re-reading the setup docs.

Custom licenceAuto-check passedDevelopment

Install WooCommerce Local Environment Runner

skills CLI
$ npx skills add woocommerce/woocommerce --skill woocommerce-local-env -a claude-code

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

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

At a glance

Starts, stops, restarts, and troubleshoots the WooCommerce Core wp-env setup and its asset build watchers without re-reading the setup docs.

  • Works in 4 steps: Check prerequisites when setup fails or… → Install dependencies from the repository… → Start the environment → …
  • Getting WooCommerce Core running locally
  • SKILL.md covers Overview, Process Ownership, Quick Commands and Setup Workflow, plus 3 more sections
  • Calls pnpm, docker and node

What it does

This skill prefers short root pnpm scripts such as a single start command and a restart command, falling back to filtered package commands when those aliases aren't available, and treats watch commands as user-owned long-running processes to run in a separate terminal rather than something it keeps alive itself.

It covers first-time setup, checking node, pnpm, and php versions and installing dependencies only when they're missing or stale, then starting the environment and recommending a targeted watcher, such as admin, blocks, or classic assets, for focused work instead of the full build. The dev site serves at a fixed local port, with a separate port reserved for tests.

When your agent uses it

  • Getting WooCommerce Core running locally
  • Diagnosing why the local WooCommerce site isn't responding
  • Choosing a targeted watcher instead of the full asset build

Example prompts

  • “Start the WooCommerce local dev environment.”
  • “Why isn't my local WooCommerce site loading after I started wp-env?”
  • “Start just the blocks watcher instead of the full build.”

Requirements

  • Node.js
  • pnpm
  • PHP

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  1. Check prerequisites when setup fails or when the user asks for first-time setup
  2. Install dependencies from the repository root only when dependencies are missing or stale
  3. Start the environment
  4. Tell the user to start a watcher in a separate terminal if frontend or asset changes need live rebuilds

What it can do on your machine

Read from SKILL.md and the folder at commit 0966a16. 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
    • node
    • php
    • composer
    • curl

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

  • Network

    No URLs in SKILL.md. Its commands use pnpm, docker and curl, 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 Local Environment Runner loads about 1.1k tokens when it runs. Until then it costs about 96 tokens; SKILL.md has 389 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~96
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 389 words (~1,132 tokens).

“Use this skill to get WooCommerce Core running locally without re-reading plugins/woocommerce/README.md and .wp-env.json.”

— opening of SKILL.md by woocommerce, Custom licence
name
woocommerce-local-env

Read the full SKILL.md on GitHub

Files

Just SKILL.md in .ai/skills/woocommerce-local-env of woocommerce/woocommerce.

Open the folder on GitHubat commit 0966a16

Compare with similar skills

WooCommerce Local Environment Runner 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 Local Environment Runner compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
WooCommerce Local Environment Runner this skillwoocommerce/woocommerce11k—~1.1kAutomated safety check: PassCustom licence
Changelogduracelltomi/gtm4wp174—~2.5kAutomated safety check: PassGPL-2.0-or-later
WordPress ProJeffallan/claude-skills12k—~1.6kAutomated safety check: PassMIT
Woocommerce Code Reviewharukiseller-droid/commerce-agent-bench101—~415Automated safety check: PassMIT
Wordpresssickn33/agentic-awesome-skills47k2 repos~348Automated safety check: PassMIT
Container Devyansongda/pay5.4k—~968Automated safety check: PassMIT

Similar skills

  • Changelog

    duracelltomi/gtm4wp

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

    174 GitHub stars~2.5k tokensUpdated today
    DevelopmentAuto-check passed
  • 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
  • Woocommerce Code Review

    harukiseller-droid/commerce-agent-bench

    Review WooCommerce hooks, product data, template overrides, escaping, and regression risks.

    101 GitHub stars~415 tokensUpdated 1 mo ago
    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
  • Container Dev

    yansongda/pay

    A skill your agent uses when local PHP environment is unavailable.

    5.4k GitHub stars~968 tokensUpdated 2 days ago
    DevOps & CloudAuto-check passed
  • Ecpay

    ECPay/ECPay-API-Skill

    ECPay 綠界科技 API 整合助手(ecpay, 綠界, 綠界科技). An agent skill from ECPay/ECPay-API-Skill.

    227 GitHub stars~10k tokensUpdated 11 days ago
    MobileAuto-check: warnings

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
  • 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

Categories

Questions about WooCommerce Local Environment Runner

What does WooCommerce Local Environment Runner do?

Starts, stops, restarts, and troubleshoots the WooCommerce Core wp-env setup and its asset build watchers without re-reading the setup docs. This skill prefers short root pnpm scripts such as a single start command and a restart command, falling back to filtered package commands when those aliases aren't available, and treats watch commands as user-owned long-running processes to run in a separate terminal rather than something it keeps alive itself.

When should I use WooCommerce Local Environment Runner?

WooCommerce Local Environment Runner fits situations like: getting WooCommerce Core running locally; diagnosing why the local WooCommerce site isn't responding; choosing a targeted watcher instead of the full asset build.

How do I install WooCommerce Local Environment Runner in Claude Code?

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

How do I install WooCommerce Local Environment Runner in Codex?

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

Can I use WooCommerce Local Environment Runner 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-local-env -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-local-env, .gemini/skills/woocommerce-local-env, .github/skills/woocommerce-local-env and .opencode/skills/woocommerce-local-env in your project.

What does WooCommerce Local Environment Runner need to run?

Going by SKILL.md and its folder, WooCommerce Local Environment Runner needs the command-line tools its instructions call (pnpm, docker, node, php, composer and curl). Our summary lists: Node.js; pnpm; PHP.

Does WooCommerce Local Environment Runner access the network?

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

Is WooCommerce Local Environment Runner 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 Local Environment Runner use?

WooCommerce Local Environment Runner 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 Local Environment Runner 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 Local Environment Runner?

Skills that share tags, products or a category with WooCommerce Local Environment Runner: Changelog (duracelltomi/gtm4wp, 174 stars), WordPress Pro (Jeffallan/claude-skills, 12k stars), Woocommerce Code Review (harukiseller-droid/commerce-agent-bench, 101 stars) and Wordpress (sickn33/agentic-awesome-skills, 47k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains WooCommerce Local Environment Runner?

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