|
|
@@ -1,19 +1,19 @@
|
|
|
---
|
|
|
-name: artifact
|
|
|
-description: Creates interactive HTML artifacts — self-contained single-file explorers that let users configure something visually through controls, see a live preview, and copy out a prompt. Use when the user asks to make an artifact, playground, explorer, or interactive tool for a topic.
|
|
|
+name: playground
|
|
|
+description: Creates interactive HTML playgrounds — self-contained single-file explorers that let users configure something visually through controls, see a live preview, and copy out a prompt. Use when the user asks to make a playground, explorer, or interactive tool for a topic.
|
|
|
---
|
|
|
|
|
|
-# Artifact Builder
|
|
|
+# Playground Builder
|
|
|
|
|
|
-An artifact is a self-contained HTML file with interactive controls on one side, a live preview on the other, and a prompt output at the bottom with a copy button. The user adjusts controls, explores visually, then copies the generated prompt back into Claude.
|
|
|
+A playground is a self-contained HTML file with interactive controls on one side, a live preview on the other, and a prompt output at the bottom with a copy button. The user adjusts controls, explores visually, then copies the generated prompt back into Claude.
|
|
|
|
|
|
## When to use this skill
|
|
|
|
|
|
-When the user asks for an interactive artifact, playground, explorer, or visual tool for a topic — especially when the input space is large, visual, or structural and hard to express as plain text.
|
|
|
+When the user asks for an interactive playground, explorer, or visual tool for a topic — especially when the input space is large, visual, or structural and hard to express as plain text.
|
|
|
|
|
|
## How to use this skill
|
|
|
|
|
|
-1. **Identify the artifact type** from the user's request
|
|
|
+1. **Identify the playground type** from the user's request
|
|
|
2. **Load the matching template** from `templates/`:
|
|
|
- `templates/design-playground.md` — Visual design decisions (components, layouts, spacing, color, typography)
|
|
|
- `templates/data-explorer.md` — Data and query building (SQL, APIs, pipelines, regex)
|
|
|
@@ -21,14 +21,14 @@ When the user asks for an interactive artifact, playground, explorer, or visual
|
|
|
- `templates/document-critique.md` — Document review (suggestions with approve/reject/comment workflow)
|
|
|
- `templates/diff-review.md` — Code review (git diffs, commits, PRs with line-by-line commenting)
|
|
|
- `templates/code-map.md` — Codebase architecture (component relationships, data flow, layer diagrams)
|
|
|
-3. **Follow the template** to build the artifact. If the topic doesn't fit any template cleanly, use the one closest and adapt.
|
|
|
+3. **Follow the template** to build the playground. If the topic doesn't fit any template cleanly, use the one closest and adapt.
|
|
|
4. **Open in browser.** After writing the HTML file, run `open <filename>.html` to launch it in the user's default browser.
|
|
|
|
|
|
-## Core requirements (every artifact)
|
|
|
+## Core requirements (every playground)
|
|
|
|
|
|
- **Single HTML file.** Inline all CSS and JS. No external dependencies.
|
|
|
- **Live preview.** Updates instantly on every control change. No "Apply" button.
|
|
|
-- **Prompt output.** Natural language, not a value dump. Only mentions non-default choices. Includes enough context to act on without seeing the artifact. Updates live.
|
|
|
+- **Prompt output.** Natural language, not a value dump. Only mentions non-default choices. Includes enough context to act on without seeing the playground. Updates live.
|
|
|
- **Copy button.** Clipboard copy with brief "Copied!" feedback.
|
|
|
- **Sensible defaults + presets.** Looks good on first load. Include 3-5 named presets that snap all controls to a cohesive combination.
|
|
|
- **Dark theme.** System font for UI, monospace for code/values. Minimal chrome.
|
|
|
@@ -72,5 +72,5 @@ function updatePrompt() {
|
|
|
- Too many controls at once → group by concern, hide advanced in a collapsible section
|
|
|
- Preview doesn't update instantly → every control change must trigger immediate re-render
|
|
|
- No defaults or presets → starts empty or broken on load
|
|
|
-- External dependencies → if CDN is down, artifact is dead
|
|
|
-- Prompt lacks context → include enough that it's actionable without the artifact
|
|
|
+- External dependencies → if CDN is down, playground is dead
|
|
|
+- Prompt lacks context → include enough that it's actionable without the playground
|