wp-devkit-playground-development
Skill0 starsChanged 34 days agoMITView on GitHub
Build, debug or review WordPress Playground Blueprints, @wp-playground/cli setups, query/embed links and shareable plugin or theme reproductions. Use for boot failures, resource/mount problems and untrusted-Blueprint review. Not a substitute for real MySQL or host testing.
In this repository20 other files it gives its agents.
- docs/llms.txtllms.txt
- wp-devkit-accessibility-reviewSkill
- wp-devkit-acf-and-content-modelingSkill
- wp-devkit-admin-ui-developmentSkill
- wp-devkit-block-developmentSkill
- wp-devkit-ci-cd-and-release-engineeringSkill
- wp-devkit-headless-and-wpgraphqlSkill
- wp-devkit-migration-upgrade-reviewSkill
- wp-devkit-performance-reviewSkill
- wp-devkit-phpstan-reviewSkill
- wp-devkit-plugin-developmentSkill
- wp-devkit-rest-api-developmentSkill
- wp-devkit-security-reviewSkill
- wp-devkit-site-audit-and-onboardingSkill
- wp-devkit-test-strategySkill
- wp-devkit-theme-developmentSkill
- wp-devkit-ui-designSkill
- wp-devkit-wcag-reviewSkill
- wp-devkit-woocommerce-devSkill
- wp-devkit-wpcli-and-opsSkill
The file
We split this skill into the rules it gives an agent
5 rules. About 0 are common, 2 are distinctive, and 3 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈2
Distinctive · estimate
This author's own choices. Worth a look.
3
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Very specific: line 8
Read references/engineering-contract.md first.
- Very specific: line 20
Test strategy and CI design for the plugin itself: wp-devkit-test-strategy and wp-devkit-ci-cd-and-release-engineering.
- Distinctive: line 28
Check step order, resource types, pinning and CORS-reachable URLs.
- Very specific: line 33
Read references/playground-development-workbook.md for the decision table, symptoms, false positives, severity and acceptance checks.
- Distinctive: line 42
Read-only leads; they do not run anything.
≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Portable reproductions and trusted Blueprints
Read references/engineering-contract.md first. Review requests stay read-only: read Blueprints and configs, never boot them, execute their PHP/SQL/WP-CLI steps, or fetch their resources. Implementation or runtime verification applies only when the request authorizes it, in a disposable environment.
Applicability
Confirm that a Blueprint (blueprint.json), @wp-playground/*, wp-now or a Playground embed exists outside .git, .claude, vendor and node_modules. If not, report Not used in this project. Guide text, documentation pages and copies of other skills are not project evidence.
Inputs
What must be reproduced or demonstrated, the artifact under test and its identity, Blueprint schema generation, resolved WordPress and PHP versions, CLI package version, Node version, mounts, and whether booting is authorized. Inspect project files first; ask only what changes the decision.
Boundaries
- Test strategy and CI design for the plugin itself:
wp-devkit-test-strategyandwp-devkit-ci-cd-and-release-engineering; this skill covers the Playground layer. - Security review of the plugin under test:
wp-devkit-security-review. - Real database, cache, cron or host behavior: use wp-env/Docker, not Playground.
Code Review Workflow
- List every step and resource; read all
runPHP,runPHPWithOptions,runSql,wp-cli,writeFile(s), archive imports and URLs before anything runs (references/blueprint-authoring.md, trust review). Do not execute them. - Validate against the schema used by the installed generation; parsing JSON is not validation.
- Check step order, resource types, pinning and CORS-reachable URLs; record resolved versions of aliases.
- For CLI work, read the installed
--help, then check flags, mounts and persistence mode (references/cli-and-local-environments.md). For links and embeds, check query parameters, bundle layout, origins (references/embedding-and-query-api.md). - Confirm the reproduction has a seed, a named trigger and an expected/observed pair; otherwise it is a setup, not a reproduction.
- Describe the fresh-instance, missing-resource and second-run checks. Report runtime behavior as unexecuted unless it was run.
Read references/playground-development-workbook.md for the decision table, symptoms, false positives, severity and acceptance checks.
Optional disposable setup material: references/playground-isolation-fixture.json (not a defect reproduction; limits in the workbook).
Implementation workflow
State the reproduction target and the smallest Blueprint that exposes it. Prefer pinned git:directory/bundled resources, install before activate, seed only what the trigger needs, and keep secrets out. Validate, then boot in a disposable instance with the pinned CLI, perform the trigger, repeat on a fresh instance, and record versions and exit codes. Do not claim production compatibility from a Playground run.
Search Patterns for Quick Detection
Read-only leads; they do not run anything. Matches are candidates; no match proves nothing. Exit 0 = match, 1 = none, 2 = error.
# Blueprint identity and versions
rg -n -g '*.json' -g '!**/{vendor,node_modules,build,dist}/**' -e 'blueprint-schema|preferredVersions|landingPage|"steps"|"features"' .
# external resources
rg -n -g '*.json' -g '!**/{vendor,node_modules,build,dist}/**' -e '"resource"|"url"|git:directory|wordpress.org/(plugins|themes)|importWxr|importWordPressFiles' .
# executable steps
rg -n -g '*.json' -g '!**/{vendor,node_modules,build,dist}/**' -e 'runPHP|runPHPWithOptions|runSql|wp-cli|writeFile|defineWpConfigConsts' .
# CLI and CI ownership
rg -n -g '*.{json,js,ts,yml,yaml,sh,ps1,md}' -g '!**/{vendor,node_modules,build,dist}/**' -e '@wp-playground|wp-now|run-blueprint|build-snapshot|follow-symlinks|blueprint-may-read-adjacent-files|--mount' .
# embeds and links
rg -n -g '*.{html,js,jsx,ts,tsx,md}' -g '!**/{vendor,node_modules,build,dist}/**' -e 'playground\.wordpress\.net|blueprint-url|startPlaygroundWeb|postMessage|event\.origin|<iframe' .
# secrets and live data in shareable artifacts
rg -n -i -g '*.{json,md}' -g '!**/{vendor,node_modules,build,dist}/**' -e 'password|secret|api[_-]?key|token|BEGIN (RSA|PRIVATE)' .Reading the leads: runPHP is a candidate only when its code or source is attacker-controlled or unreviewed; login in a disposable fixture is intended; latest is acceptable in an exploratory demo; a secrets hit needs the value inspected and redacted in the report.
Output Format
Lead with the result and reviewed scope (files read, nothing executed). Confirmed concern: file:line, actor, trigger, reachable path, impact, confidence, minimal fix, regression check. Keep candidates and "not established" items separate. Implementation: Blueprint/command, resolved versions, CLI and Node versions, exit codes, fresh-instance result, what remains unexecuted. A successful Playground boot does not prove MySQL, hosting, cache or production behavior.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

