AutoGineer
Generated banner for Wp Playground
Generated logo for Wp Playground

Wp Playground

WordPressOfficialPublished by WordPress

  • Skill
  • Tool integration
  • Software development
  • GPL-2.0-or-later
  • No issues found
Download ZIP

From the author

Use as the WordPress Playground routing wrapper for ambiguous Playground work, local CLI runs with @wp-playground/cli, playground.wordpress.net share links, browser previews, WebMCP site tools, snapshots, mounts, version switching, and Xdebug. For Blueprint JSON authoring or review, use the blueprint skill directly.
— the description by WordPress

AutoGineer summary

Written by AutoGineer from the skill’s own files, not by the author

WordPress Playground is a routing skill designed to help developers select the appropriate workflow for their WordPress environment needs. It acts as a central hub for managing WordPress instances running in WebAssembly with SQLite. Whether you are performing local development via the CLI, debugging with Xdebug, or configuring browser-based shareable links, this skill directs you to the correct reference material while ensuring that specialized tasks like Blueprint JSON authoring are handled by the dedicated blueprint skill.

What it does

  • Routes users to the correct Playground workflow based on their specific development needs.
  • Provides guidance for local CLI operations including server management and file mounting.
  • Facilitates debugging sessions using Xdebug and runtime log inspection.
  • Supports version switching for both WordPress and PHP to test compatibility.
  • Assists in creating snapshots for shareable reproduction cases and CI artifacts.
  • Integrates with browser-based Playground website workflows for quick site previews.

When to use it

  • When you need to set up a local WordPress environment for plugin or theme development.
  • When you need to reproduce a bug using specific WordPress or PHP versions.
  • When you need to debug a WordPress instance running in a WebAssembly environment.
  • When you need to create a shareable link or snapshot of a WordPress site configuration.
  • When you are unsure which specific Playground tool or reference to use for a task.

Advantages

  • Provides a unified interface for diverse Playground tasks.
  • Ensures consistent handling of disposable, SQLite-backed WordPress environments.
  • Simplifies complex tasks like local file mounting and version pinning.
  • Prevents configuration errors by routing specialized tasks to dedicated skills.
  • Enables efficient debugging of WebAssembly-based WordPress instances.

Usage examples

“How do I start a local WordPress server for my plugin development?”
The agent will guide you to use the CLI start command, ensuring your plugin is correctly mounted and the environment is persisted.
“I need to debug a site running in Playground with Xdebug.”
The agent will provide instructions on using the --xdebug flag with the CLI and configuring your IDE path mappings.
“How can I test my theme against WordPress 6.5 and PHP 8.2?”
The agent will show you how to use the server command with explicit --wp and --php version flags.
“Create a snapshot of my current site for a bug report.”
The agent will walk you through the build-snapshot command to generate a shareable ZIP file of your current site state.

Install

  1. Download the skill as a ZIP:

    https://mp-staging.autogineer.com/agent-skills/wordpress/wp-playground/download

  2. Unzip it into the cross-client skills folder of your project:

    mkdir -p .agents/skills && unzip wp-playground.zip -d .agents/skills

Documentation by WordPress

WordPress Playground

This is a thin routing wrapper. Use it to pick the right Playground workflow, then load only the focused reference or skill needed for the task.

Procedure

  1. Identify the user intent: Blueprint authoring/review, local CLI execution, browser-only website/share link workflow, Xdebug/stuck CLI run, or a mixed Playground request.

  2. Route to the focused source below, loading more than one only when the request has multiple distinct parts.

  3. For mixed requests, delegate Blueprint JSON work to blueprint, then return here for runtime, CLI, debugging, or sharing guidance.

  • Blueprint JSON, schema, steps, resources, bundles, or Blueprint review: use the blueprint skill directly. Do not duplicate Blueprint schema details here.

  • Local CLI execution: read references/cli.md for @wp-playground/cli server, run-blueprint, build-snapshot, mounts, version switching, and local validation.

  • Xdebug or stuck CLI runs: read references/debugging.md for Xdebug, runtime logs, worker flags, and stuck CLI runs.

  • Browser-only Playground website workflows: read references/website.md for Query API and Blueprint URL setup, share links, and browser limitations. It routes existing-site operations to separate WebMCP, Playground MCP, and Sites API references; load only the selected method. Unless the user requests a specific connection method, prefer available WebMCP tools for supported browser operations.

Inputs required

  • The intended workflow: Blueprint authoring, local CLI run, website/share link, snapshot, or debugging.

  • Project or bundle path if local code must be mounted or packaged.

  • Desired WordPress/PHP versions if compatibility matters.

  • Port preference if a local server is needed.

  • Whether browser-only sharing or local filesystem access is required.

Guardrails

  • Playground instances are disposable, SQLite-backed environments; never point them at production data.

  • Keep Blueprint JSON guidance in blueprint so the schema and examples have one source of truth.

  • For local CLI work, verify Node.js 20.18+ and npm/npx before running commands.

  • Browser-only Playground cannot read local filesystem paths; use public URLs, hosted ZIP bundles, or inline Blueprint JSON.

Verification

  • For Blueprint content, validate against the published schema and follow the blueprint skill verification.

  • For local CLI runs, verify the mounted plugin/theme or Blueprint side effects in the Playground instance.

  • For share links, open the generated URL and confirm the expected landing page and installed assets load.

Failure modes

  • Blueprint work routed here: stop and use the blueprint skill for schema keys, steps, resources, bundles, validation, or Blueprint review.

  • Local filesystem needed in a browser-only workflow: use references/cli.md; playground.wordpress.net cannot read local filesystem paths.

  • Shareable browser link requested from a local CLI workflow: use references/website.md; local server URLs are not portable share links.

  • Debugging treated as a second-hop reference: read references/debugging.md directly for Xdebug, logs, worker flags, and stuck CLI runs.

Escalation

  • If the task needs PHP extensions, native database access, persistence, or production-like infrastructure that Playground cannot provide, use a full WordPress stack such as wp-env, Docker, or the project-provided environment.

Files

Requirements and compatibility

Works with: Claude Code, Claude apps, OpenAI Codex, GitHub Copilot, Cursor, Gemini CLI, Kiro, OpenCode, Goose, Amp, Roo Code, JetBrains Junie, Factory Droid, Devin (ex-Windsurf), Mistral Vibe, OpenHands, Letta

“Works with” means the tool reads the open Agent Skills format; a skill written for one tool may use features others lack.

Needs: Needs Node.js

The author says: Targets WordPress 7.0+, PHP 7.4.0+. Playground CLI requires Node.js 20.18+; runs WordPress in WebAssembly with SQLite.

Security

No issues found by our static scan· No issues found

A static scan is not a guarantee. Skills are third-party content: review a skill before you let an agent use it.

Attribution and licence

Published by
WordPress
Publisher
WordPress (Official)
Source
WordPress/agent-skills · skills/wp-playground · commit 7374e6f
Licence
GNU General Public License v2.0 or later (redistribution allowed)
  • LICENSE (added by AutoGineer from LICENSE)
  • ATTRIBUTION.md (written by AutoGineer)
Synced

AutoGineer is not affiliated with or endorsed by WordPress.

Download ZIP

The ZIP holds the skill’s files, its licence files and an ATTRIBUTION.md. Download wp-playground.zip