Agent skill

WooCommerce Dev Cycle

by woocommerce in 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.

Custom licenceAuto-check passedDevelopment

Install WooCommerce Dev Cycle

skills CLI
$ npx skills add woocommerce/woocommerce --skill woocommerce-dev-cycle -a claude-code

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

GitHub CLI
$ gh skill install woocommerce/woocommerce woocommerce-dev-cycle --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-dev-cycle .claude/skills/woocommerce-dev-cycle && 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-dev-cycle
GitHub stars
11k
Used in
3 other repos
Token cost
~431 tokens
SKILL.md length
180 words
Files
6
Skills in repo
11
Repo updated
First seen
Licence
Custom licence

At a glance

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.

  • Works in 5 steps: Running tests: See running-tests.md for… → Code quality: See code-quality.md for… → PHP linting patterns: See… → …
  • Running PHP tests for a WooCommerce change
  • SKILL.md covers Instructions, Development Workflow and Key Principles
  • Calls pnpm

What it does

The skill points the agent to five topic files: running tests, code quality, PHP linting patterns, JavaScript and TypeScript i18n patterns for translatable strings and placeholders, and markdown linting. The standard loop is to change code, run the relevant tests with pnpm run test:php:env and a filter, check the branch's PHP with pnpm run lint:changes:branch:php, fix issues with pnpm run lint:php:fix, and commit only after the tests pass.

Its principles are to run tests after every change, use narrow filters during development, fix lint errors only in code from the current branch, and read test failures for the expected versus actual values. The test environment sets up WordPress and WooCommerce automatically.

When your agent uses it

  • Running PHP tests for a WooCommerce change
  • Fixing PHP code style errors in changed files
  • Writing translatable strings in JavaScript or TypeScript
  • Linting markdown files in the repo

Example prompts

  • “Run only the tests for my cart discount class and explain any failures.”
  • “Lint the PHP changes on this branch and fix what can be fixed automatically.”
  • “Fix the i18n placeholder warnings in my React component.”
  • “Check the markdown I edited against the repo's linting rules.”

Requirements

  • A WooCommerce checkout with pnpm installed

Workflow steps

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

  1. Running tests: See running-tests.md for PHP and JavaScript test commands, test environment setup, and troubleshooting
  2. Code quality: See code-quality.md for linting and code style fixes
  3. PHP linting patterns: See php-linting-patterns.md for common PHP linting issues and fixes
  4. JS/TS i18n patterns: See js-i18n-patterns.md for translatable string patterns and placeholder usage
  5. Markdown linting: See markdown-linting.md for markdown file linting and formatting

What it can do on your machine

Read from SKILL.md and the folder at commit 6173f77. 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

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

  • Network

    No URLs in SKILL.md. Its commands use pnpm, 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 Dev Cycle loads about 431 tokens when it runs. Until then it costs about 43 tokens; SKILL.md has 180 words of instructions outside code blocks.

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

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 180 words (~431 tokens).

“This skill provides guidance for the WooCommerce development workflow, including running tests, code quality checks, and troubleshooting.”

— opening of SKILL.md by woocommerce, Custom licence
name
woocommerce-dev-cycle

Read the full SKILL.md on GitHub

Files

SKILL.md and 5 other files in .ai/skills/woocommerce-dev-cycle of woocommerce/woocommerce.

  • SKILL.md
  • code-quality.md
  • js-i18n-patterns.md
  • markdown-linting.md
  • php-linting-patterns.md
  • running-tests.md

Open the folder on GitHubat commit 6173f77

Used in 3 other repositories

We found 5 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 3 other GitHub owners. This page covers the copy in woocommerce/woocommerce, which our catalogue first saw on October 7, 2026.

Compare with similar skills

WooCommerce Dev Cycle 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 Dev Cycle compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
WooCommerce Dev Cycle this skillwoocommerce/woocommerce11k3 repos~431Automated safety check: PassCustom licence
DevAutomattic/wordpress-activitypub582—~1.1kAutomated safety check: PassMIT
Antfuoyjt/uniapp-vue3-template627—~1.3kAutomated safety check: PassMIT
Changelogduracelltomi/gtm4wp174—~2.2kAutomated safety check: PassGPL-2.0-or-later
WordPress ProJeffallan/claude-skills12k—~1.6kAutomated safety check: PassMIT
Ha Frontend Testinghome-assistant/frontend5.7k—~1.7kAutomated safety check: PassApache-2.0

Similar skills

  • Dev

    Automattic/wordpress-activitypub

    Development workflows for WordPress ActivityPub plugin including wp-env setup, testing commands, linting, and build processes.

    582 GitHub stars~1.1k tokensUpdated today
    DevelopmentAuto-check passed
  • Antfu

    oyjt/uniapp-vue3-template

    Anthony Fu's {Opinionated} preferences and best practices for web development

    627 GitHub stars~1.3k tokensUpdated 4 mo ago
    DevelopmentAuto-check passed
  • 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 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 4 days ago
    DevelopmentAuto-check passed
  • Ha Frontend Testing

    home-assistant/frontend

    Home Assistant frontend testing and validation workflow. An agent skill from home-assistant/frontend.

    5.7k GitHub stars~1.7k tokensUpdated today
    Testing & QAAuto-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

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 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 Dev Cycle

What does WooCommerce Dev Cycle do?

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. The skill points the agent to five topic files: running tests, code quality, PHP linting patterns, JavaScript and TypeScript i18n patterns for translatable strings and placeholders, and markdown linting. The standard loop is to change code, run the relevant tests with pnpm run test:php:env and a filter, check the branch's PHP with pnpm run lint:changes:branch:php, fix issues with pnpm run lint:php:fix, and commit only after the tests pass.

When should I use WooCommerce Dev Cycle?

WooCommerce Dev Cycle fits situations like: running PHP tests for a WooCommerce change; fixing PHP code style errors in changed files; writing translatable strings in JavaScript or TypeScript; linting markdown files in the repo.

How do I install WooCommerce Dev Cycle in Claude Code?

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

How do I install WooCommerce Dev Cycle in Codex?

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

Can I use WooCommerce Dev Cycle 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-dev-cycle -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-dev-cycle, .gemini/skills/woocommerce-dev-cycle, .github/skills/woocommerce-dev-cycle and .opencode/skills/woocommerce-dev-cycle in your project.

What does WooCommerce Dev Cycle need to run?

Going by SKILL.md and its folder, WooCommerce Dev Cycle needs the command-line tools its instructions call (pnpm). Our summary lists: A WooCommerce checkout with pnpm installed.

Does WooCommerce Dev Cycle access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is WooCommerce Dev Cycle 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 Dev Cycle use?

WooCommerce Dev Cycle 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 Dev Cycle use?

About 431 tokens (SKILL.md is roughly 1.7k 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 Dev Cycle?

Skills that share tags, products or a category with WooCommerce Dev Cycle: Dev (Automattic/wordpress-activitypub, 582 stars), Antfu (oyjt/uniapp-vue3-template, 627 stars), Changelog (duracelltomi/gtm4wp, 174 stars) and WordPress Pro (Jeffallan/claude-skills, 12k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains WooCommerce Dev Cycle?

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