# Blueprint

Use when the deliverable is WordPress Playground Blueprint JSON or a Blueprint bundle...

- Repository: https://github.com/WordPress/agent-skills (2319 stars)
- Category: Testing
- License: see repository
- Last updated: 2026-10-26
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add WordPress/agent-skills --skill blueprint -g -a claude-code -y`
Codex: `npx skills add WordPress/agent-skills --skill blueprint -g -a codex -y`
Cursor: `npx skills add WordPress/agent-skills --skill blueprint -g -a cursor -y`
Gemini CLI: `npx skills add WordPress/agent-skills --skill blueprint -g -a gemini-cli -y`

## Description

Use when the deliverable is WordPress Playground Blueprint JSON or a Blueprint bundle, including creating, editing, reviewing, validating schema keys, choosing steps/resources, and debugging Blueprint files. For only running or sharing a Playground environment, use wp-playground.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# WordPress Playground Blueprints

## Overview

A Blueprint is a JSON file that declaratively configures a WordPress Playground instance, installing plugins/themes, setting options, running PHP/SQL, manipulating files, and more.

**Core principle:** Blueprints are trusted JSON-only declarations. No arbitrary JavaScript. They work on web, Node.js, and CLI.

## Quick Start Template

```json
{
  "$schema": "https://playground.wordpress.net/blueprint-schema.json",
  "landingPage": "/wp-admin/",
  "preferredVersions": { "php": "8.3", "wp": "latest" },
  "steps": [{ "step": "login" }]
}
```

## Top-Level Properties

All optional. Only documented keys are allowed, the schema rejects unknown properties.

The rest: https://github.com/WordPress/agent-skills/blob/HEAD/skills/blueprint/SKILL.md