# blueprint

Create and inspect JSON Blueprints for WordPress Playground with this skill. Use it to configure an environment as a Blueprint file, rather than just launch or share one.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 3700 installs · ★ 2298
- Author: WordPress
- License: LicenseRef-Unknown · policy=link-only · description only; the file stays with the author
- Source: https://github.com/WordPress/agent-skills/tree/HEAD/skills/blueprint/SKILL.md
- Updated: 2026-10-21
- HTML: https://affpapa.org/en/nevibecode/skills/wordpress-blueprint

## What it does

The skill guides an agent through drafting and editing WordPress Playground Blueprints. It can describe plugin and theme setup, site settings, file operations, and ordered actions, as well as check schema keys and diagnose Blueprint issues. For launching or sharing a Playground environment without working on its Blueprint, use `wp-playground` instead.

A Blueprint describes configuration in JSON, and keys outside the schema are rejected. When execution order matters, spell out actions as steps: the `login`, `plugins`, `siteOptions`, and `constants` shortcuts are added in an unspecified order. That can affect the sequence you expect. Compatibility is listed for WordPress 7.0+ and PHP 7.4.0+; the Playground CLI or a browser can be used.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add WordPress/agent-skills --skill blueprint -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/blueprint/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/blueprint/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add WordPress/agent-skills --skill blueprint -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/blueprint/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add WordPress/agent-skills --skill blueprint -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/blueprint/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install WordPress/agent-skills blueprint
```

2. **Manually: put the files in place**
- File: `.github/skills/blueprint/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add WordPress/agent-skills --skill blueprint -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/WordPress/agent-skills --path skills/blueprint
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/blueprint/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add WordPress/agent-skills --skill blueprint -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/WordPress/agent-skills/tree/HEAD/skills/blueprint/SKILL.md

## When to use it
- create a Blueprint for a WordPress Playground setup
- check JSON properties against the Blueprint schema
- define plugin or theme installation steps
- debug a Blueprint file

## Example prompts
- Create a WordPress Playground Blueprint that installs a plugin and opens the admin page.
- Check this Blueprint for properties rejected by its schema.
- Set an explicit step order for installing a theme and configuring the site.

## Similar
- [setup-matt-pocock-skills](https://affpapa.org/en/nevibecode/skills/setup-matt-pocock-skills.md) — skill · 1052851 installs
- [ask-matt](https://affpapa.org/en/nevibecode/skills/ask-matt.md) — skill · 766587 installs
- [to-tickets](https://affpapa.org/en/nevibecode/skills/to-tickets.md) — skill · 711230 installs
- [writing-plans](https://affpapa.org/en/nevibecode/skills/writing-plans.md) — skill · 282859 installs
- [caveman-review](https://affpapa.org/en/nevibecode/skills/caveman-review.md) — skill · 411800 installs
- [caveman-compress](https://affpapa.org/en/nevibecode/skills/caveman-compress.md) — skill · 411500 installs

## Other versions with the same name
- [blueprint · affaan-m](https://affpapa.org/en/nevibecode/skills/blueprint.md) — 4600 installs
- [blueprint · ghaida](https://affpapa.org/en/nevibecode/skills/ghaida-blueprint.md) — 2700 installs
- [blueprint · astronomer](https://affpapa.org/en/nevibecode/skills/astronomer-blueprint.md) — 552 installs

From the same set: [wordpress/agent-skills](https://affpapa.org/en/nevibecode/by/wordpress/agent-skills.md) — 19 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md