About playground
Playground Builder is a skill for creating self-contained interactive HTML explorers with controls, live previews, and copyable natural-language prompts. It guides template selection, implementation, and hands-on checks of rendered behavior and accessibility.
Key features
- 01Builds a single-file HTML explorer
- 02Provides controls and live preview
- 03Generates copyable natural-language prompts
- 04Adapts one of six supplied templates
- 05Checks interaction, states, and keyboard use
Use cases
- 01Explore product or design options interactively
- 02Create a data explorer from a template
- 03Review concepts or document differences in a browser
Install
Copy the command and run it in a terminal.
$
npx skills add https:/ / github.com/ paulrberg/ agent-skills --skill playgroundAfter installing, type/playgroundin Claude Code to confirm it loaded.
Bundled files
References and scripts installed along with SKILL.md.
agents/openai.yamltemplates/code-map.mdconcept-map.mddata-explorer.mddesign-playground.mddiff-review.mddocument-critique.mdDetails
From the project READMEPlayground Builder
Build a self-contained interactive HTML explorer with controls, live preview, and a copyable natural-language prompt.
Workflow
- Infer the product context, audience, decisions to explore, and required states. Existing design systems and explicit user requirements override this skill's visual defaults.
- Read exactly one closest template and adapt it:
templates/design-playground.mdtemplates/data-explorer.mdtemplates/concept-map.mdtemplates/document-critique.mdtemplates/diff-review.mdtemplates/code-map.md
- Write one HTML file with inline CSS and JavaScript and no external runtime dependencies.
- Open it in a browser, interact with every control and preset, inspect representative viewport sizes, and verify live preview, prompt output, copy feedback, empty/error states, and keyboard usability. Fix rendered defects before completion.
Opinionated Defaults
Use these when product context does not indicate otherwise:
- controls beside a live preview, with prompt output below;
- a polished light theme, system UI font, monospace code/values, minimal chrome;
- sensible non-empty initial state and 3–5 cohesive named presets;
- one state object, one update path, and immediate preview/prompt refresh;
- controls grouped by concern, with advanced controls collapsed;
- prompt text that explains the desired outcome in natural language and mentions only non-default choices.
Invariants
- No Apply button: relevant changes render immediately.
- The prompt is actionable without seeing the playground and is not a raw state dump.
- Copy has visible transient feedback and a usable fallback when the Clipboard API fails.
- Presets update controls, preview, and prompt consistently.
- Do not add controls that do not affect either the preview or the generated prompt.
Completion requires the self-contained file plus rendered, interactive inspection evidence; opening the file without exercising it is insufficient.
Comments
Markdown supported