open-design-preview
Skill678 starsChanged yesterdayMITView on GitHub
Open an Open Design artifact in a live browser preview, where you can see it update as it changes, click elements to comment on them, and compare check screenshots before and after — use whenever the user asks to see, show, preview or open an Open Design artifact, or wants to comment on one visually
We split this skill into the rules it gives an agent
3 rules. About 0 are common, 1 is distinctive, and 2 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈1
Distinctive · estimate
This author's own choices. Worth a look.
2
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 13
Use the user's own words. If they say "artifact", "design tokens" or give a file path, use those terms back.
- Very specific: line 14
Keep the machinery out of replies: no tool names, no ids like od:prototype:poster-hero, no internal files (.artifact.json, .comments.json, …
- Very specific: line 32
Call open_open_design_preview with that entryPath.
≈ “Common” is an estimate: at least 1 in 5 of the 308,232 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
<!-- generated:open-design-agent-kit -->Show an Open Design artifact in the browser preview.
Request: the rest of the user's message (if there is none, ask the user: "Which design should the preview show?")
How to talk to the user. Many people using Open Design don't write code, so:
- Use the user's own words. If they say "artifact", "design tokens" or give a file path, use those terms back; otherwise use the plain words below.
- Keep the machinery out of replies: no tool names, no ids like
od:prototype:poster-hero, no internal files (.artifact.json,.comments.json,config.json), and not the words "register", "manifest", "sidecar", "entry" or "surface", unless the user used them first. - Explain a print term the first time it comes up, in one short clause, and not again.
- Say where a file is the way the user would find it ("in your Open Design folder, under seed-swap-flyer"). Give a raw path only where the user can click it (Claude Code, Claude Desktop's Code tab, VS Code) or asks for it.
- End each reply that finishes a step with one line on what they can do next, with at most two options ("Want it in Instagram sizes too, or is it ready to print?").
| Instead of | Say |
| artifact, entry, registered | your design, saved |
| design system, active design system | your style (the first time: "a saved style: colours, fonts and spacing") |
| surface, skill, template, recipe | kind of design, starting layout, or nothing |
| workspace, output directory | your folder, your Open Design folder |
| bleed | print edge ("a few millimetres extra that the printer trims off") |
| trim size | final size |
| preflight findings, errors | "I checked it and fixed…", "one thing to look at:" |
| export | save as PDF, save as an image |
| inline preview, MCP App | the preview above |
- Work out which artifact is meant. Registered artifacts are the files under the Open Design output folder (default
.open-design/) that have a.artifact.jsonfile next to them. Use the one the request names; if it names none, use the one you made or changed most recently in this conversation. If that still doesn't settle it, callopen_open_design_previewwithoutentryPath: the preview then lists every design, and the user picks there. - Call
open_open_design_previewwith thatentryPath. - Tell the user in one or two sentences what happened, using the tool's result: where the preview opened (or the URL to open, when it couldn't open a window), that it reloads by itself when the design changes, and that they can click Comment, then an element, to leave a comment, and Send to agent when they want you to apply them.
In this repository47 other files it gives its agents.
- article-magazineSkill
- card-twitterSkill
- card-xiaohongshuSkill
- data-reportSkill
- deck-guizang-editorialSkill
- deck-open-slide-canvasSkill
- deck-swiss-internationalSkill
- doc-kami-parchmentSkill
- frame-data-chart-nytSkill
- frame-flowchart-stickySkill
- frame-glitch-titleSkill
- frame-light-leak-cinemaSkill
- frame-liquid-bg-heroSkill
- frame-logo-outroSkill
- frame-macos-notificationSkill
- guizang-pptSkill
- mockup-device-3dSkill
- open-design-campaignSkill
- open-design-critiqueSkill
- open-design-deck-from-sourceSkill
- open-design-design-system-from-urlSkill
- open-design-docsSkill
- open-design-exploreSkill
- open-design-integrationsSkill
- open-design-newSkill
- open-design-posterSkill
- open-design-publishSkill
- open-design-recurringSkill
- open-designSkill
- open-design-social-postSkill
- poster-heroSkill
- ppt-keynoteSkill
- resume-modernSkill
- social-carouselSkill
- social-reddit-cardSkill
- social-spotify-cardSkill
- social-x-post-cardSkill
- social-youtube-thumbnailSkill
- vfx-text-cursorSkill
- video-hyperframesSkill
- openspec-apply-changeSkill
- openspec-archive-changeSkill
- openspec-exploreSkill
- openspec-ff-changeSkill
- openspec-onboardSkill
- openspec-proposeSkill
- openspec-sync-specsSkill
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.

