skilld
All skills
automattic avatar

/wp-playground

@95e374f official
by automatticautomattic/agent-skills211 stars
37

Use for WordPress Playground workflows: fast disposable WP instances in the browser or locally via @wp-playground/cli (server, run-blueprint, build-snapshot), auto-mounting plugins/themes, switching WP/PHP versions, blueprints, and debugging (Xdebug).

Ask your Agent

Use this Skill: https://skilld.dev/gh/automattic/agent-skills/wp-playground

This session only. Nothing lands on disk.

referencescli-commands.md

≈391 tokens on demand. Your agent reads this file only when SKILL.md points to it.

Playground CLI command cheatsheet

Requires Node.js 20.18+ and npm/npx. Latest version: 3.0.20 (November 2025)

What's new in 2025

  • PHP 8.3 is now the default (since July 2025).
  • New PHP extensions: ImageMagick, SOAP, and AVIF GD support.
  • OpCache enabled: 42% faster response times (185ms → 108ms average).
  • Multi-worker default: --experimental-multi-worker now defaults to CPU count minus one.

Install / run server

  • npx @wp-playground/cli@latest server [--port=9400] [--auto-mount] [--wp=<ver>] [--php=<ver>] [--verbosity=debug] [--blueprint=<url-or-path>]
  • Mounts:
    • --auto-mount (detect plugin/theme in CWD)
    • --mount=/abs/host:/vfs/path (repeatable)
    • --mount-before-install (apply mounts before WP install)

Run a blueprint

  • npx @wp-playground/cli@latest run-blueprint --blueprint=<file-or-url> [--blueprint-may-read-adjacent-files] [--wp=<ver>] [--php=<ver>] [--verbosity=debug]
  • Use for scripted setup; no persistent server.

Build a snapshot

  • npx @wp-playground/cli@latest build-snapshot --blueprint=<file-or-url> --outfile=./site.zip [--verbosity=debug]
  • Produces a sharable ZIP usable by Playground UI or other CLI commands.

Debugging flags

  • --xdebug / --enable-xdebug (depends on release) to start Xdebug listener.
  • --experimental-multi-worker to speed multi-step blueprints; disable if unstable.

Version control

  • --wp=<version> to pick WordPress version (defaults to latest).
  • --php=<version> to pick PHP version (defaults to 8.3 since July 2025).

Source: SKILL.md on GitHub

Third-party checks

1 warning17d4 checks · Risk SAFE
  • Gen Agent Trust Hub17d

    The skill provides instructions for using WordPress Playground, a tool for running ephemeral WordPress instances. It involves downloading official packages from Automattic via npm and interacting with official WordPress theme and plugin repositories. While the tool supports executing code via blueprints, this is a standard feature performed within an isolated environment.

  • Socket17d

    No alerts

  • Snyk17d

    Risk: LOW · No issues

  • Runlayer7mo

    4/4 files flagged

Provenance

Signed by skilld at 95e374f. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub 5 months ago.

Dormantupdated 9 months ago

Capability

Other metadata
compatibility
Targets WordPress 6.9+ (PHP 7.2.24+). Playground CLI requires Node.js 20.18+; runs WP in WebAssembly with SQLite.

Topics

  • Testing
  • wordpress
  • playground
  • webassembly
  • php
  • blueprints
  • xdebug
  • snapshots
  • sqlite

README badge

README badge for automattic/agent-skills/wp-playground

What it does

Spins up disposable WordPress instances in the browser or locally via @wp-playground/cli, with auto-mounting of plugins/themes, version switching, blueprints, and Xdebug debugging. Targets WordPress 6.9+ running in WebAssembly with SQLite, ideal for quick testing without full stack setup or reproducing issues across WP/PHP versions.

Generated from the current SKILL.md.

Frequently asked

Does this work with WordPress versions older than 6.9?
No. The skill targets WordPress 6.9+ with PHP 7.2.24+. Older versions are not supported.
What Node.js version is required?
Node.js 20.18 or higher. The Playground CLI will not run on earlier versions.
Can I use this to test against production data?
No. Playground instances are ephemeral and SQLite-backed — they are designed for isolated testing only and should never point at production data.
Does this support database systems other than SQLite?
No. Playground runs WordPress in WebAssembly with SQLite. If you need native DB access or PHP extensions, you should use a full WP stack or wp-env instead.
Can I debug plugin and theme code with this skill?
Yes. Use the `--xdebug` flag when starting the server, then connect your IDE (VS Code or PhpStorm) to the exposed port for step-through debugging.

Generated from the current SKILL.md. These answers refresh after source changes.