WordPress Blueprint

---
name: blueprint
description: Use when creating, editing, or reviewing WordPress Playground blueprint JSON files. Triggers on mentions of blueprints, playground configuration, or requests to set up a WordPress demo environment.
---

# WordPress Playground Blueprints

A Blueprint is a trusted JSON-only file that declaratively configures a WordPress Playground instance — installing plugins/themes, setting options, running PHP/SQL, and manipulating files. No arbitrary JavaScript; works on web, Node.js, and CLI.

## How to use
1. Start from the template with `$schema` set to `https://playground.wordpress.net/blueprint-schema.json`, a `landingPage`, and `preferredVersions` (php major.minor or `latest`; wp major or `latest`/`nightly`).
2. Use top-level shorthands — `login`, `plugins` (wp.org slugs), `siteOptions`, `constants` — for common setup; only documented keys are allowed (the schema rejects unknown properties).
3. Use the `steps` pipeline when execution order matters (shorthands are prepended in unspecified order).
4. Reference resources by type: `wordpress.org/plugins|themes` (slug), `url`, `git:directory` (url+ref), `literal`, `bundled`, or `zip`.
5. Run via the Playground CLI or browser; validate against the schema.

Full skill & source: https://github.com/WordPress/agent-skills/tree/aa735ea7111c7924ee988306bcef70439e17dec9/skills/blueprint