{
  "markdown": "> All Playground skills will be published together with [WordPress Agent skills](https://github.com/WordPress/agent-skills/)\n\n# wp-playground\n\nWordPress Playground skills and MCP server configuration, packaged as installable extensions for AI coding assistants.\n\n## What's included\n\n- **Skills** from [WordPress/agent-skills](https://github.com/WordPress/agent-skills):\n  - `blueprint` — How to write WordPress Playground blueprint JSON files\n  - `wp-playground` — How to use the Playground CLI (server, run-blueprint, build-snapshot, mounting, debugging)\n- **MCP server** config for [`@wp-playground/mcp`](https://www.npmjs.com/package/@wp-playground/mcp)\n\n## Installation\n\n### Claude Code\n\n```\n/plugin install wp-playground@<marketplace>\n```\n\n### Codex CLI\n\nInstall via plugin directory or local `marketplace.json`.\n\n### Gemini CLI\n\n```\ngemini extensions install https://github.com/WordPress/wp-playground\n```\n\n## How it works\n\nEach provider discovers its manifest and skills from this repo:\n\n| Provider | Manifest | Skills | MCP config |\n|----------|----------|--------|------------|\n| Claude Code | `.claude-plugin/plugin.json` | Auto-discovered from `skills/` | `.mcp.json` |\n| Codex CLI | `wp-playground/.codex-plugin/plugin.json` | Auto-discovered from `wp-playground/skills/` | `wp-playground/.mcp.json` |\n| Gemini CLI | `gemini-extension.json` | Auto-discovered from `skills/` | Inline in manifest |\n\nThe `description` field in each manifest tells the AI when to activate the plugin and whether to prefer the CLI or MCP tools.\n\n## Testing locally\n\n### Claude Code\n\nThe repo includes a marketplace manifest at `.claude-plugin/marketplace.json`. From the repo root, add it as a local marketplace and install the plugin:\n\n```\nclaude plugin marketplace add ./ --scope local\nclaude plugin install wp-playground\n```\n\nStart a new Claude Code session and verify the skills loaded (e.g. ask \"What skills do you have?\"). To clean up:\n\n```\nclaude plugin uninstall wp-playground\nclaude plugin marketplace remove wp-playground-local\n```\n\n### Codex CLI\n\nFrom the repo root, open a Codex session and type `/plugins` in the TUI to find and install **wp-playground**. The repo-local marketplace at `.agents/plugins/marketplace.json` makes the plugin discoverable automatically.\n\nCodex requires plugins to live in a named subdirectory (paths in the marketplace manifest cannot reference the repo root directly). The `wp-playground/` directory is the Codex plugin root and holds the canonical `skills/`, `.mcp.json`, and `.codex-plugin/plugin.json`. The repo root has symlinks (`skills → wp-playground/skills`, `.mcp.json → wp-playground/.mcp.json`) so that Claude Code and Gemini can discover them at the expected paths.\n\n> **Note:** Codex copies plugins into its cache. After changing plugin files you must reinstall via `/plugins` to pick up the changes.\n\n### Gemini CLI\n\nLink the repo as a local extension for development (changes are reflected immediately):\n\n```\ngemini extensions link /path/to/wp-playground-ai-plugins --consent\n```\n\nStart a new Gemini CLI session and verify with `/extensions` — you should see **wp-playground** listed. To clean up:\n\n```\ngemini extensions uninstall wp-playground\n```\n\n## Publishing\n\n### Validation\n\nValidation runs automatically via [CI](.github/workflows/validate-plugin.yml) on every push and pull request. A [pre-commit hook](.githooks/pre-commit) also runs `claude plugin validate .` and `gemini extensions validate .` locally. To enable the hook:\n\n```\ngit config core.hooksPath .githooks\n```\n\n### Claude Code\n\n**Official marketplace:** Submit the plugin at https://claude.ai/settings/plugins/submit (or https://platform.claude.com/plugins/submit for Console).\n\n**Custom marketplace:** Push to GitHub. Users add the repo as a marketplace and install:\n\n```\n/plugin marketplace add WordPress/wp-playground\n/plugin install wp-playground@wp-playground-local\n```\n\n### Codex CLI\n\nThe Codex plugin root is the `wp-playground/` subdirectory (with its own `.codex-plugin/plugin.json`, `skills/`, and `.mcp.json`).\n\n**Official marketplace (via Apps SDK):** Self-serve plugin publishing is not yet available. The current path to the official Codex Plugin Directory is through the [OpenAI Apps SDK submission process](https://developers.openai.com/apps-sdk/deploy/submission):\n\n1. Host the MCP server on a publicly accessible domain.\n2. Complete organization verification in the [OpenAI Platform Dashboard](https://platform.openai.com/).\n3. Submit for review from the dashboard with app name, description, privacy policy URL, MCP server details, screenshots, and test prompts.\n4. Once approved, the plugin appears in both the ChatGPT Apps Directory and the Codex Plugin Directory.\n\n> **Note:** Self-serve publishing is [coming soon](https://developers.openai.com/codex/plugins) according to OpenAI.\n\n**Local / team distribution:** Push to GitHub. Users clone the repo and run Codex from the repo root — the `.agents/plugins/marketplace.json` makes the plugin auto-discoverable via `/plugins` in the TUI.\n\n### Gemini CLI\n\nGemini extensions are installed directly from a public GitHub repo. Push to GitHub and users can install via:\n\n```\ngemini extensions install https://github.com/WordPress/wp-playground\n```\n\nThe `gemini-extension.json` at the repo root is discovered automatically.\n\n## Keeping skills up to date\n\nA [weekly CI workflow](.github/workflows/sync-skills.yml) checks [WordPress/agent-skills](https://github.com/WordPress/agent-skills) for updates and opens a PR if files changed.\n\n## Links\n\n- [WordPress Playground docs](https://wordpress.github.io/wordpress-playground/)\n- [Playground CLI](https://www.npmjs.com/package/@wp-playground/cli)\n- [MCP server](https://www.npmjs.com/package/@wp-playground/mcp)\n- [Agent skills source](https://github.com/WordPress/agent-skills)\n",
  "bytes": 5809,
  "sha": "7cacee729b7a270b68fa5ff38e1731c24b53c068a8c2a4cfebf63c9a82d4cc5a",
  "repo_slug": "bgrgicak/wp-playground-ai-plugins",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_bgrgicak_wp_playground_ai_plugins_wordpr_896581c6/readme"
}