skill CX Codex

wp-env — Claude Code skill: what it does, how to install

Q: How do I install wp-env in Claude Code?

Run `npx skills add WordPress/agent-skills --skill wp-env -a claude-code` in your terminal.

Configures and manages Docker-based WordPress environments using @wordpress/env. Useful when you need a real MySQL database, WP-CLI, or PHPUnit testing.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓

npx skills add WordPress/agent-skills --skill wp-env -a claude-code

Open on GitHub

What wp-env does

The skill guides your agent through setting up and troubleshooting local WordPress environments via @wordpress/env. It detects plugins, themes, or core checkouts from the folder structure and handles configurations defined in .wp-env.json and .wp-env.override.json.

Commands execute inside dedicated containers such as cli, wordpress, or mysql. This approach keeps real MySQL data intact between restarts and provides shell access through wp-env run. Keep Docker running before triggering any commands, or the setup halts immediately.

You need Node.js 18.12.0 or newer alongside an active Docker installation. Bare plugin slugs from WordPress.org will fail in the configuration file; you must provide direct ZIP download URLs or GitHub paths instead.

What it helps with

spin up a Docker-based WordPress instance for plugins or themes
run PHPUnit test suites against a persistent MySQL database
execute WP-CLI commands inside the environment container
configure Xdebug on port 9003 for PHP troubleshooting

Example prompts for the agent

Start a local WordPress environment with wp-env and enable Xdebug
Run PHPUnit tests inside the wp-env container
Reset the wp-env development database

How to install wp-env

1Skills CLI (Vercel)

npx skills add WordPress/agent-skills --skill wp-env -a claude-code

2Manually: put the files in place

~/.claude/skills/wp-env/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/wp-env/

1Skills CLI (Vercel)

npx skills add WordPress/agent-skills --skill wp-env -a codex

2Manually: put the files in place

.agents/skills/wp-env/SKILL.md

For all projects use ~/.agents/skills/

1Skills CLI (Vercel)

npx skills add WordPress/agent-skills --skill wp-env -a cursor

2Manually: put the files in place

.cursor/skills/wp-env/SKILL.md

Cursor also reads .agents/skills/ and .claude/skills/

1GitHub CLI

gh skill install WordPress/agent-skills wp-env

2Manually: put the files in place

.github/skills/wp-env/SKILL.md

1Skills CLI (Vercel)

npx skills add WordPress/agent-skills --skill wp-env -a gemini-cli

2Platform CLI

gemini skills install https://github.com/WordPress/agent-skills --path skills/wp-env

Manually: put the files in place

.devin/skills/wp-env/SKILL.md

The legacy .windsurf/skills/ path still works

Skills CLI (Vercel)

npx skills add WordPress/agent-skills --skill wp-env -a opencode

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about wp-env

How do I install wp-env in Claude Code?

Run npx skills add WordPress/agent-skills --skill wp-env -a claude-code in your terminal.

What does the wp-env skill do?

It instructs the agent on managing Docker-based WordPress development, writing .wp-env.json configs, and running WP-CLI commands.

When should you pick wp-env over wp-playground?

Choose wp-env when your workflow requires a persistent MySQL database, arbitrary container execution via wp-env run, or full WP-CLI access.

ddev-expert madsnorgaard A skill that feeds your agent DDEV commands: starting containers, database work, config and common troubleshooting. CX Codex +1 314installs managing-astro-local-env astronomer Controls local Apache Airflow environments with Astro CLI across Docker and standalone modes. Helps start services, tail logs, and query the Airflow API. CX Codex +1 1,400installs docker-sandboxes-env docker Generates and validates declarative sbxenv.yaml files for Docker Sandboxes. Handy when setting up reproducible agent environments and host lifecycle commands. CX Codex +1 725installs coolify-manager ajmcclary A skill for running Coolify through its official CLI and API: service status, logs, containers, SSL, WordPress fixes. CX Codex +1 502installs wordpress-testing-qa bobmatnyc A skill for testing WordPress plugins and themes: PHPUnit integration, WP_Mock, PHPCS and CI/CD. Useful when your test setup needs structure. CX Codex +1 413installs wordpress-pro https://github.com/Jeffallan This skill builds WordPress themes, plugins, Gutenberg blocks, and WooCommerce features. Use it for REST API work, hooks, security checks, and performance tuning. CX Codex +1 9,700installs

From the same set19

wp-abilities-api A skill for WordPress Abilities API work: registering abilities and categories in PHP, exposing them over REST, reading them in JS. Useful when a client can't see an ability. CX Codex +1 4,300installs wp-interactivity-api Guides AI agents through WordPress Interactivity API implementation and debugging. Helps configure directives, connect script modules, and eliminate hydration mismatches. CX Codex +1 4,200installs wpds Feeds WordPress Design System docs to your agent through an MCP server, so UI work lands on real components and tokens instead of guesses. CX Codex +1 4,000installs blueprint Create and inspect JSON Blueprints for WordPress Playground with this skill. Use it to configure an environment as a Blueprint file, rather than just launch or share one. CX Codex +1 3,700installs wp-plugin-directory-guidelines Audits WordPress plugins against 18 WordPress.org Directory guidelines, verifying GPL license compatibility and freemium rules before submission. CX Codex +1 3,600installs wp-abilities-audit This skill reviews a WordPress plugin’s REST surface and writes a planning document for proposed Abilities API registrations. CX Codex +1 2,700installs wp-abilities-verify Verifies WordPress plugin Abilities API registrations, flags hidden database writes in readonly callbacks, and validates schemas. CX Codex +1 2,600installs wp-patterns Creates and updates WordPress block patterns, then checks registration and markup. Useful for templates, starter pages, and Query Loop layouts. CX Codex +1 2,200installs