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.

referencesdebugging.md

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

Debugging WordPress Playground

  • Start CLI with Xdebug: server --auto-mount --xdebug (or --enable-xdebug depending on release). The CLI prints host/port and IDE key to configure your debugger.
  • If breakpoints are not hit, confirm:
    • IDE listens on the port shown by CLI.
    • Path mappings include the mounted VFS path used by Playground.
  • For slow or stuck runs:
    • Add --verbosity=debug to see step-level logs.
    • Disable --experimental-multi-worker if it was enabled.
  • For mount issues:
    • Prefer absolute paths in --mount.
    • Use --mount-before-install when installer steps need files present early.
  • To inspect runtime state:
    • Open the Playground browser console; the Service Worker logs network/FS events.
    • Use the “Terminal” tab (if available) to run WP-CLI inside the instance.

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.