open-design
Compare original and translation side by side
🇺🇸
Original
English🇨🇳
Translation
Chinese<!-- generated:open-design-agent-kit -->
<!-- voice:end -->
Open Design is a bundled catalog of design skills and design templates (reusable task recipes and rendering styles — both usable interchangeably as a ) plus design systems (brand-inspired visual token sets), exposed through the MCP server's tools.
skillIdopen-designEvery skill/template id is namespaced as (e.g. ), where is one of: , , , , , , , . Always pass the full namespaced id as . Note: mode means "a skill that helps author a design-system deliverable" — it has nothing to do with , which selects from the separate library of ~150 prebuilt brand design systems (see step 2).
od:<mode>:<name>od:deck:guizang-pptmodeprototypedeckdesign-systemimagevideotemplateutilityaudioskillIddesign-systemdesignSystemIdA small, curated subset of skills/templates also has its own explicit skill — if the user's request closely matches one of those, prefer invoking it directly; it pins the exact skillId and often a ready-made example brief, removing any guesswork. Otherwise, follow the flow below yourself.
/open-design:<id>All Open Design content (skill/template text, design system tokens, example briefs) is delivered to you as plain text through the MCP tool calls below — never as a file path. You never need to, and should not, browse or search for Open Design's own files anywhere on disk; and already return everything you need as plain text.
<!-- voice:start -->
list_open_design_skillsprepare_open_design_briefHow 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 , no internal files (
od:prototype:poster-hero,.artifact.json,.comments.json), and not the words "register", "manifest", "sidecar", "entry" or "surface", unless the user used them first.config.json - 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 |
Follow this flow:
-
Check the tools are wired up. This skill does nothing on its own — every step below calls a tool theMCP server provides. If
open-design(or any other tool named below) isn't available to you right now, the server hasn't been registered in this project yet. Set it up, then retry from step 1:list_open_design_skills-
Claude Code: point the user to the setup steps in Claude Code.
-
Codex CLI: point the user to the setup steps in Codex.
-
Any other MCP-capable agent (Cursor, etc.): point the user to Getting started, which shows how to add the Open Design MCP server to any agent.
-
Claude Desktop Chat or claude.ai (no Open Design tools in the chat): don't make anything yet. Welcome the user in plain words, in this shape:Open Design can't save or check designs in this chat yet. Two ways to fix that:
- Connect a folder: make a folder called "Open Design" (in Documents, for example), then click + in this chat, choose Add folder and pick it.
- Install the Open Design extension for Claude Desktop: download it from https://github.com/feimacode/open-design-agent-kit/releases/latest, double-click the file, then start a new chat.
What's the design for?Don't name file types, packages, commands or tools in it. Offer the goals from step 1 below as examples of what they can say ("promote an event", "show an idea", "get hired"). Only if they want to go ahead without either, make one self-contained HTML page and publish it with your own Artifact tool, and say it can't use saved styles, checks or saving as PDF and images.
Run the command yourself if you have shell access; otherwise tell the user the exact command to run and wait for their confirmation before continuing. Skip this step entirely once the tools are available.In Claude Desktop (a chat or Cowork session with a folder the user connected), the server runs on the user's machine and starts in their home folder, and your file tools see the folder under a different path. Before any other Open Design tool, callwith the folder's path on the user's machine (the oneset_open_design_workspacelists underget_device_info). Every path other tools return is relative to that folder: join it onto your own path for the folder when you read or write files, and when you attach or show a file with your own tools, give the full path: a relative one resolves against your shell's current folder, which moves when youconnectedFolders. If a tool says it would be working in the home folder, this is what it's asking for. The first time you set the folder in a chat, tell the user in one sentence where their designs will be saved (the folder's name and thecdfolder inside it) and that they can open it any time; don't repeat it for later designs.Open DesignIn Claude Desktop Chat with no folder (is in your tools), your own file tools, if you have any, can't reach the server's files. Calluse_open_design_managed_workspacefirst with a short name for the design, and tell the user once, in one sentence, the folder's absolute path from its result (underuse_open_design_managed_workspaceby default), so they can open it. Then save every design file with~/Documents/Open Design/(the whole file each time, under the output directory) instead of your own file tools, and register, check and export as usual. Show the design withwrite_open_design_fileonce; later rounds update that inline copy by itself. Don't keep a per-round Claude artifact preview here. The managed folder is the source of truth: to edit, send the full new file throughshow_open_design_artifact. If the chat has a connected folder, usewrite_open_design_fileinstead.set_open_design_workspace -
-
Call(optionally with a
list_open_design_skillsand/or an exactquery) to find a skill or design template that matches what the user wants. Pick the best match by name/description/triggers, and prefer a result'smode(adapted to the user's specifics) over inventing your own brief when one is present and closely fits.examplePrompt -
There is an active design system, persisted per project (a localfile). If the user mentions a brand, company, industry, or visual style that differs from what's active, call
.open-design/config.json(optionally with alist_open_design_design_systemsand/or an exactquery— call with no arguments first to see categories, and check each result'scategoryflag) to find the right one, and pass its id explicitly toactive— doing so also makes it the new active one going forward, so you don't need to re-specify it on later requests in this project. For phone screens (the Mobile app surface, or a brief like "a budgeting app that feels like Monzo"), look in theprepare_open_design_briefcategory first, with the app's name asMobile Apps: those systems are adapted from the real iOS apps (tab bars, sheets, iOS point sizes). Usequery(e.g.<app>-ios) for phone screens even when a web system of the same brand exists (spotify-ios); the web one stays the right choice for web pages. If the user hasn't mentioned any direction and one is active, just omitspotifyfromdesignSystemIdand it will use the active one. If none is active and the user hasn't named a direction, recommend one before preparing a new design (not for an edit, a remix or an export): callprepare_open_design_briefwith what you know from the request, the conversation and the workspace (recommend_open_design_design_systems,industries,moods,theme,surface,likeBrands), leaving out what you don't know. If its result hasbrief, ask them once, as short multiple-choice options: throughquestionswhere it is in your tools, else in one message (or your host's question tool if it has one), and accept "you pick"; then call it again with the answers. Ask them in the same message as any surface questions, three in total at most. Show the shortlist: whereshow_open_design_questionsis in your tools, pass it the recommendedshow_open_design_design_systems; elsewhere, a short numbered list with each name and itsids. Don't wait for a pick unless you asked questions: go ahead with the first recommendation, pass its id toreason, and say which style you used and that they can pick another. Ifprepare_open_design_briefisn't in your tools, userecommend_open_design_design_systemsinstead, or go without one. Only calllist_open_design_design_systemsdirectly when the user wants to pin a look before generating anything ("let's use the Starbucks look from now on").set_active_design_system -
Callwith the chosen
prepare_open_design_brief, optionalskillId(per step 2), and the user'sdesignSystemId(their request, in their own words). This returnsbriefto follow, ainstructions, and thesuggestedEntryPath/designSystemIdactually used (whether explicit or defaulted from active) — mention which one it was if it wasn't obvious from the conversation. It does NOT write any files.designSystemName -
Follow the returnedand author the artifact's entry file (plus any supporting files) yourself, using your own file-editing tools. Do not look for a separate tool to write the design content.
instructions -
Callwith the entry path, a
register_open_design_artifact, akind, and anytitle, so the artifact is recognized and gets its manifest sidecar written.supportingFiles -
Callwith the entry path before telling the user it's done (after creating an artifact, and again after a substantial edit). It renders the artifact and returns screenshots plus preflight findings: fix every error, then look at the screenshots for what the checks can't measure — balance, hierarchy, crowded or empty areas, text over busy imagery — and fix what's clearly wrong. Taste warnings (
check_open_design_artifact,slop-glow,card-row,uniform-surface,type-scale) are worth a look: fix them unless the brief or the design system asks for that look, and never addintentonly to silence one. Re-check after fixing, but stop after two fix rounds and tell the user about anything left. Then get a second look before you call it done: once the checks are clean or the fix rounds are spent, run thedata-od-allowskill, which has a fresh critic judge the latest check run against the brief and the design system on purpose and hierarchy, typography, colour and contrast, layout and rhythm, copy, states, and fit, so build with those in mind. One critique round: onopen-design-critique, apply its fixes once, register and re-check, then report done without another critique; onpolish, tell the user what's wrong and ask before rebuilding; onrework, it's done. The brief or design system wins over a finding against a look it asks for, and the user can ask for another opinion at any time or say they don't want one. 3D designs are the exception: when the check returns a 3D review sheet, a clean check isn't the end. Get the critique the check result asks for (theshipskill's scorecard, from a subagent where your host has one), then fix, re-check and re-critique for up to three critique rounds, which replace the two-fix-round limit and the second look above. Don't describe the screenshots to the user unless they ask: each run's screenshots are saved for them, and the browser preview's Checks panel shows them before and after (the result also lists the saved paths). If it returns3d-object, skip checking and tell the user once that visual checks need Chrome, Edge or Chromium installed.no-browser -
Optionally callto confirm what was written before telling the user it's done.
get_open_design_artifact -
After the first artifact you register in a session, callwith its entry path, unless the user said they don't want it, so they can see it. It opens a live browser preview that reloads whenever the file changes, so don't call it again after edits; call it again only to switch to another artifact. Mention that they can click Comment in the preview to leave comments on elements.
open_open_design_previewIn Claude Desktop's Code tab (its preview tool, named like, is in your tools), use the Browser pane instead of a separate window: the first time you show a design in the session, callpreview_start(once per project; tell the user once, in one sentence, that you added a preview entry toset_up_open_design_browser_pane), then start the.claude/launch.jsonconfiguration it names with that preview tool. The pane opens on the newest registered design and reloads when its files change. For a later design, reload the pane if your preview tools can, or tell the user it's in the pane's list. If the pane can't start, fall back toopen-design-preview.open_open_design_previewIn Claude Desktop Chat (a chat conversation, not the Code tab or a terminal), callwith the entry path instead: it shows the design inline in the conversation, where the user can comment and click Ask Claude to apply. Call it once per design, after its firstshow_open_design_artifact: that copy follows later edits and applied comments by itself, so don't show the same design again unless the user asks. The register result says which applies. If its result says the host doesn't show MCP Apps, fall back toregister_open_design_artifactas above. Its export buttons post a request in the chat: runopen_open_design_previewwith the format named and tell the user the path. For an exploration, passexport_open_design_artifactto show the directions side by side; when the user picks one with Take this one, ask which next step they want before callingexplorationId. A style-tile exploration also offers Use as design system, which asks directly forchoose_open_design_directionwithchoose_open_design_direction.next: "save-design-system"Picking by eye in Claude Desktop Chat. Two more tools are listed only where the host shows MCP Apps inline, so use them only when they are in your tool list:shows the remixable examples as a gallery of live previews (filter byshow_open_design_examples,queryormode), andsurfaceshows design systems as tiles (passshow_open_design_design_systemsfor a shortlist). Use them when the user wants to choose a starting example or a brand look and hasn't named one. Picks arrive as chat messages naming the tool to call: "Remix this" meansidswith that skillId (ask what to make first if the user hasn't said); "Use this design system" meansremix_open_design_examplewith that id. Elsewhere, keep toset_active_design_systemandlist_open_design_skills.list_open_design_design_systemsLinking the public gallery. Some results carry a link to the Open Design gallery, a website with every example and design system:fromgallery.urlandshow_open_design_examples, andshow_open_design_design_systemsfromdesignSystem.galleryUrl. They appear only while the gallery is live; never write a gallery link yourself. When the user is browsing (wants to look before deciding: "show me some examples", "what styles are there?", "ideas for a café menu"), show the in-chat gallery where it is in your tools, then add one line linkingregister_open_design_artifact("See them all in the Open Design gallery."), unless you already linked the gallery in this conversation. When a design is ready and its register result hasgallery.url, name the design system with that link in the sentence that says it's ready ("It uses the Kami design system."), the first time you use that design system in the conversation; not again for later rounds or designs in the same style. Never link the gallery before building on a concrete request ("a poster for our seed swap on Saturday"), after an export or publish, or in a recurring job run.designSystem.galleryUrlAsking with taps in Claude Desktop Chat.is listed only where the host shows MCP Apps inline. Where it is in your tool list, ask every short multiple-choice question through it instead of a chat message: the surface and design-system questions before a build, which direction after an exploration, "fix these?" after a review. Up to four questions, each with a shortshow_open_design_questions,id, atext(kind,singleormulti) and up to eighttext; an option can carryoptions(imageRef,designSystem:<id>,example:<skillId>orartifact:<entryPath>), never a URL. Don't repeat the questions in chat. The answer arrives as a message starting "Answers:" with a linecheckRun:<entryPath>: read that JSON (question id to option id, an array for<!-- od-answers {...} -->, typed text, ormulti, meaning choose for them and say what you chose). Accept typed answers too. The artifact view also has three quick replies under the design ("Looks good", "Change something", "Try another direction"); each posts a message saying what to do next. Elsewhere, ask in one chat message.you-pick
When a request says what the design is for but not what to make ("help me promote our seed swap", "something to get a UX job"), or is too vague to tell, call with : its are plain-language aims (Promote an event, Show an idea, Get hired…). Take the goal that fits, or show the goals (label and description) and ask one question, "What's it for?". Then call it with set to that id and continue with the surface marked , asking which one only when the request doesn't settle it and the goal leads to several. Don't show the user the list of surfaces unless they ask what kinds of thing you can make.
list_open_design_skillssurface: "list"goalsgoaldefaultWhen a request names a kind of thing to make (a prototype or landing page, app screens (a settings page, table, form, search or detail screen of a product, or a sign-in, onboarding, paywall or settings flow: surface , never ), mobile app, slides, document, wireframe, animation, résumé, research synthesis, data report, poster or flier, social post, diagram, 3D object), call with set to that kind first ( shows the ids). Pick from its entries and follow the surface's prompt when it names one. Questions: a surface lists a few , each with , a and what the answer . Ask only the ones the request, the conversation and the workspace don't already answer: at most three in total, merged with any design-system recommender questions (surface ones first), in one message, as multiple choice, accepting "you pick" (then use the question's ). A request that already says enough gets no questions. Pass the answers to as (question id to answer) and what you decided without asking as (up to six short lines), then pass both, with the request in one line as , to as . When the design is ready, list the assumptions in one sentence and invite a change ("I assumed a dark theme and one sign-up button; say if you want otherwise"). A request for one specific template or style still goes straight to it. Never pick an entry marked : it only advertises an upstream skill and has no instructions here.
app-screensprototypelist_open_design_skillssurfacesurface: "list"questionsoptionsdefaultchangesdefaultprepare_open_design_briefanswersassumptionstextregister_open_design_artifactbriefstub: trueFor engineering documents (an RFC, ADR, postmortem, PR explainer or changelog page), use the matching skill (, , , , ). Gather the facts yourself first, from git (, ) and the files involved, and register what you read as . Never invent incident facts, dates or numbers: ask for them. To turn a folder of Markdown docs into pages, follow the docs flow (load the skill): one page per file, one template for the set, and on a re-run only the pages whose Markdown changed.
od:prototype:rfcadrpostmortempr-explainerchangelog-pagegit loggit diffsourcesopen-design-docsFor a recurring design ("every week", "on a schedule", "each month from the new numbers") or a prompt that says "Run the Open Design job <path>", load the skill: the job lives in , each run starts with (stop when it returns ) and ends with , and job runs never publish publicly or post to social networks.
open-design-recurring.open-design/jobs/<id>.job.mdstart_open_design_job_runskipfinish_open_design_job_runIf the request is based on a document (it names or attaches a report, spec, spreadsheet, PDF or existing deck, or points at repository files such as , , an RFC or a metrics CSV), generate from it rather than from memory: pass those workspace paths as to . Typical examples: "a release deck from CHANGELOG.md", "an architecture review from docs/adr/", "a board update from metrics/q3.xlsx", "turn docs/q3-report.docx into a pitch". The tool extracts each document (DOCX, PPTX, XLSX, PDF with , Markdown, text, CSV) to Markdown and returns instructions that make you write an outline first and stop for the user's approval before building. Follow them: read the extracted text by line range, write , show it, and wait (unless the user said to just build it). Then register with the same ; its result lists numbers on the page that it couldn't find in the sources, so check and fix each one. Use on its own to look inside a document before deciding how to use it. For a whole folder of files (such as ), pass the relevant files individually (up to 10).
CHANGELOG.mddocs/adr/sourcesprepare_open_design_briefpdftotextoutline.mdsourcesread_open_design_sourcedocs/adr/When the user wants to choose colors and fonts, a palette or a type pairing, or a look for a new brand ("show me some color and type options", "what could our brand look like?"), run the exploration with the style-tile skill (): it makes compact tiles (palette with contrast, type specimen, components) instead of pages, 4 by default. To vary the active design system rather than replace it ("the same but warmer"), use with one direction per variation. When the user picks a tile, call with : the tile's tokens are copied verbatim into the new system, which then becomes active.
skillId: "od:design-system:style-tile"axis: "custom"choose_open_design_directionnext: "save-design-system"If the user explicitly asks for options to compare ("show me three directions for…", "a few different versions of…", "explore some alternatives", "I'm not sure what style I want, show me options"), run a design exploration instead of steps 3–5. Don't explore for an ordinary request ("design a pricing page"): it costs several generations.
- Call with the
prepare_open_design_explorationand the user'sskillId(andbrief2–4 if they gave a number; default 3). The tool picks deliberately different directions itself: visual styles when no design system is active, layout/narrative structures when one is (so the brand is kept), or passcountwithaxis: "custom"when the user named what should vary ("three hero concepts"). PasscustomDirectionsonly when the brief's tone clearly calls for specific ones (e.g.directionIdsfor a magazine,editorial-monoclefor an art or agency site). If the result says the active design system was set aside, tell the user.brutalist-experimental - For each returned direction, follow followed by that direction's own
sharedInstructions, write its file at itsinstructions, and callsuggestedEntryPathwith theregister_open_design_artifactand that direction'sexplorationId. Directions are quick sketches (one screen, or a cover plus two slides), not full builds. If you can delegate work to sub-agents, generate the directions in parallel, passing each onedirectionIdplus its ownsharedInstructions.instructions - Call with
compare_open_design_exploration. If you can view images, open the contact sheet and check the directions really look different (layout and hero pattern, not just colour); regenerate any that resembles another.contactSheet: true - Show the user the comparison page path (; it opens in any browser straight from the file system and shows every direction side by side) and the contact sheet path, each on its own line, briefly describe how each direction differs, and ask which one to take forward (through
compareFilewhere it is in your tools, with each direction as an option andshow_open_design_questions).imageRef: "artifact:<its entry path>" - When the user picks one, call with
choose_open_design_direction:next(build the chosen sketch out at full fidelity),build-out(the same, taking named aspects from other directions viamerge, e.g. "B with A's hero"), ormergeFrom(turn the direction into a reusable custom design system). Follow the returnedsave-design-systemand register the result as they say.instructions
Generated artifacts land under the project's Open Design output directory (default ) so they stay visible and trackable in version control like any other project file. After registering or updating an artifact, tell the user where it was written, with its workspace-relative entry path (e.g. ) on its own line: in Claude Desktop's Code tab, clicking that path opens it in the Browser pane. Don't open the HTML file in a browser yourself: (or in Claude Desktop Chat) is how it is shown.
.open-design/.open-design/coffee-poster/coffee-poster.htmlopen_open_design_previewshow_open_design_artifactComments from the preview. When the user says they left comments (or pastes the preview's "Apply my comments" instruction, or the inline preview posts it), call for that entry. Its lists each comment's note and the element it points at (, , , ); screenshots of up to 4 commented elements are attached as images, and every comment's path is listed. Change only those elements, with your own file-editing tools, then call again with the comments' ids as so their pins leave the preview, and run the check as in step 6. In Claude Desktop Chat, the inline copy updates by itself; tell the user it's updated rather than showing it again.
get_open_design_artifactopenCommentsselectortexthtmlHintrectscreenshotregister_open_design_artifactresolvedCommentIdsIf the user wants to start from or riff on an existing example rather than build something new, prefer (skillId must be an entry with ) over — it copies a working starting artifact into the project and tells you to modify it rather than regenerate from scratch. See references/remixable-examples.md for the full list of what's available to remix, grouped by mode — check it before calling with if a quick skim already answers the question.
remix_open_design_exampleremixable: trueprepare_open_design_brieflist_open_design_skillsremixableOnly: trueIf the user wants a brand/style that isn't one of the ~150 bundled design systems ("use our own brand colors", "match our website", "set up a custom design system for..."), call with a , a describing the brand, and an optional if they gave you a website to match. It returns for writing a new yourself (same file shape as every bundled design system) plus, when a was given, a best-effort extracted starting palette/font list to incorporate — treat that as a rough starting point, not ground truth. It does NOT write any files. After writing the file, call with the returned — there's no separate "register" step for design systems; a written is immediately selectable, the same way generated artifacts are immediately visible once written.
create_open_design_design_systemnamebriefsourceUrlinstructionsDESIGN.mdsourceUrlset_active_design_systemidDESIGN.mdOnce the user is happy with a generated or refined artifact and wants it turned into real, working code in this app ("turn this into a real component", "add this to the app", "wire this into my codebase"), call with the artifact's . It returns for reproducing the artifact's design as idiomatic code in this project's actual application — read the returned instructions carefully: they'll tell you to find and follow a real existing component in this codebase as your pattern reference (its styling approach, conventions, file organization) rather than copying the artifact's HTML/CSS verbatim, and to leave routing/navigation wiring as a separate step for the user. It does NOT write any files itself.
port_open_design_artifact_to_appentryPathinstructionsWorking with Impeccable. After porting, if a skill named is in your own skill list, end your reply with one suggestion: run (or ) on the component you just wrote. Say nothing about Impeccable when you don't have that skill. In a code project, once you've set a design system there and the project has no , you may offer once to save it as the project's so other tools can read it; when the user agrees, call again with (it never overwrites an existing file).
impeccable/impeccable polish/impeccable auditDESIGN.mdDESIGN.mdset_active_design_systemwriteProjectDesignMd: trueWhen the user wants reusable components rather than one page in the app ("make Material 3 components for my React app from this", "a component library from this design", "an MUI / shadcn set for these screens"), call instead, with the artifact's (or the for every screen) and , or . Follow its stages in order: write the inventory and stop for the user's yes before any code, use the generated theme as is, wrap the library's own components, add the gallery, run the app's type check, then call the tool again with . It writes no app code itself. "Material 3" means .
prepare_open_design_component_libraryentryPathscollectionIdlibrarymuishadcnautocomponents.mdrecordmuiWhen the artifact is meant to be posted or uploaded as an image (an X/Twitter post, Instagram or LinkedIn image, Xiaohongshu cards, a YouTube thumbnail, a poster), call with its after registering it. It renders the artifact in a headless browser and writes PNG/JPEG file(s) under the artifact's own folder, sized from the source skill automatically unless you pass /. For multi-card designs, give each card a attribute and pass to get one numbered image per card. Pass with the platform's upload limit (X 5000000, YouTube thumbnail 2000000, Instagram 8000000). Tell the user the exported file paths. For any social-post request ("make an X post…", "an Instagram carousel…", "a YouTube thumbnail…"), load the skill first. It maps each platform and format to the right canvas size, skillId and export arguments (and asks the user which platform when that's unclear), then walks through generate → register → export. Animated designs (motion frames, title cards, animated charts, sprite or WebGL animations) export as video or GIF: call with , or . Time runs on a virtual clock, so the frames are exact and the same on every run; the length comes from the page ( frames or the longest animation) unless you pass . Before exporting, call with (e.g. ) to see the start, middle and end. Export needs an installed ffmpeg: if it reports or , tell the user what to install rather than trying another way. Compositions built with the HyperFrames framework are the exception: the brief's own instructions render them with the HyperFrames CLI. After registering a slide deck, offer to export it as PowerPoint or PDF, and when the user wants that, call with or (one full-bleed image per slide: exact, but not editable). When the user wants slides they can edit (in PowerPoint, Keynote, Google Slides or Canva), add to the export: text boxes, shapes and pictures they can change, close to the deck but not identical, with gradients, SVG diagrams and effects kept as a background picture. Tell them what the result lists as staying a picture and which fonts they need installed. Never write your own conversion script for this. on an ordinary page prints it as a vector PDF.
export_open_design_artifactentryPathexports/widthheightdata-od-cardselector: "[data-od-card]"maxBytesopen-design-social-postexport_open_design_artifactformat: "mp4""webm""gif"data-durationdurationcheck_open_design_artifactat[0, 1.5, 3]no-ffmpegffmpeg-missing-encoderexport_open_design_artifactformat: "pptx""pdf"editable: truepptxformat: "pdf"For a diagram of a system — architecture, dependencies, a request flow, a database schema (ERD), a state machine or a sequence of calls ("diagram how our services talk", "draw the schema", "how does checkout work?") — use the skill (, or remix its example ). Read the relevant code first and draw only what you read. Write nodes with / and hidden links, never coordinates, then call (it inserts the layout runtime; never write that script yourself), register with kind and the files you read as , and check it. When a later check or reports that its sources changed, offer to redraw it.
diagramod:prototype:diagramod:prototype:diagram:exampledata-rankdata-laneadd_open_design_diagram_runtimediagramsourcesget_open_design_artifactFor a 3D object — a product shot, a 3D logo, a turntable, or the user's own / model ("make a 3D render of our bottle", "turn the logo into 3D", "a product shot of models/headphones.glb") — use the skill (). It's one three.js scene with studio lighting, materials from the design system's tokens, a ground shadow and a turntable. Load three.js exactly as the skill says (its import map for the pinned module build): older and script tags no longer exist and leave the page blank. Copy a user's model under next to the design and load it with , framing the camera from its bounding box. The page must expose (, resolved after a direct render once everything has loaded, and ); exports and checks turn on software WebGL and wait for it. Fix findings before exporting. For a cut-out to place on slides or pages, export with from a scene with no background; for a turntable, or with equal to one rotation.
.glb.gltf3d-objectod:prototype:3d-objectthree@0.160.0three.min.jsexamples/jsassets/GLTFLoaderwindow.odScenereadyrotatewebglformat: "png"transparent: trueformat: "mp4""gif"durationFor an HTML email (newsletter, launch or product-update email), use the skill: it builds a table-based, inbox-safe email marked . Check it, then export with and (add once the user has hosted the folder, so image URLs become absolute), and tell the user to send themselves a test before sending to a list. When the user wants a design pasted into another editor (a WeChat Official Account article, a Notion page, a newsletter tool), export with and , , or ; styles are inlined from what the browser rendered. To use either file, the user opens it in a browser, selects all and copies.
email-campaigndata-od-emailexport_open_design_artifactformat: "email"baseUrlassets/format: "paste"targetwechatnotionnewslettergenericFor a campaign (one message across several channels or sizes, ad banners in several sizes, or the same creative in several languages), load the skill first: agree a copy deck saved as a CSV, build one fluid master bound to it with (headline and subhead marked for long translations), check every chosen shape per row, and export with , and .
open-design-campaigndata-od-fielddata-od-fitpresetsdatacampaignSheet: trueFor a poster, flyer, certificate or other print piece, or when the user wants an existing design in other sizes or as a print-ready PDF, load the skill first. In short: ask print or screen and which size if unclear; pass that canvas (e.g. , , , ) with to and the same to (a fluid poster reflows to any shape, so the size can change later); make any QR code with (never draw a fake one); run and fix every preflight error; then export with set to the format id (print formats give a PDF with bleed, trim and bleed boxes). exports several shapes at once and shows them all in one image; tunes a shape that looks wrong (in place, for fluid posters), and on the export makes one file per row of the user's spreadsheet. Print PDFs are RGB: say so.
open-design-posterformata3a2ig-portraitstoryfluid: trueprepare_open_design_briefformatregister_open_design_artifactcreate_open_design_qr_codecheck_open_design_artifactpresetpresetsshapeSheet: trueadapt_open_design_artifactdataWhen the user wants to share a design with people who don't have this project open: for a link ("publish this", "deploy it", "give me a link to send the team", "host it somewhere"), call with its (pass only if they already said where; otherwise it returns the choices to show them). It builds a deploy-ready folder and returns step-by-step instructions to run with your terminal under the user's own CLI login, or as a temporary no-account link. Follow them exactly: they stop for the user's explicit yes before anything goes online, and after a successful deploy you call the tool again with to record the link. For a single file to attach or send ("export it as one HTML file"), call with instead; nothing goes online. The skill walks through the whole flow.
publish_open_design_artifactentryPathproviderpublishedexport_open_design_artifactformat: "standalone"open-design-publishFor Figma: to turn a frame into code, call with the frame link ("Copy link to selection"); to put a finished design into Figma as editable layers, call with its . Both work through the user's Figma connection, and fall back to the Figma import plugin.
pull_open_design_figma_framepush_open_design_artifact_to_figmaentryPathWhen a step would hand work to another service (import into Canva, read or push a Figma frame, save to Google Drive, write a Notion page, share in Slack, or post to a social network), call first with the (plus for a social post). Then:
list_open_design_integrationscapabilityplatform- Check your own tools for one matching the returned patterns, including deferred or on-demand tools you can search for. If one is there, use it, calling its tools by their server-defined names (e.g. Canva's ).
import-design-from-url - If none is, offer to set up the first provider, once per conversation and only when the step needs it: say what it does and what sign-in it needs. Only after the user says yes, follow the returned setup steps (user-level configuration only). Never install silently, and never ask for an API key or write one into a file: the user sets it themselves.
- Help the user sign in and reload if needed, then confirm by listing your tools.
- If the user declines or setup fails, carry on with the workflow's manual path.
Anything that publishes, sends or posts on the user's account still needs their go-ahead first.
<!-- generated:open-design-agent-kit -->
<!-- voice:end -->
Open Design 是一套内置的 design skills 和 design templates 目录(可复用的任务配方和渲染样式,两者均可互换使用并作为 ),同时还包括 design systems(受品牌启发的视觉 token 集),并通过 MCP server 提供的工具对外开放。
skillIdopen-design每个 skill/template id 的命名空间格式均为 (例如 ),其中 的取值为:、、、、、、、。始终将完整的命名空间 id 作为 传入。注意:mode 表示“一种帮助创作 design-system 交付物的 skill”,它与 无关;后者用于从另一个包含约 150 套预构建品牌 design systems 的库中选择(参见步骤 2)。
od:<mode>:<name>od:deck:guizang-pptmodeprototypedeckdesign-systemimagevideotemplateutilityaudioskillIddesign-systemdesignSystemId一小部分经过精心筛选的 skills/templates 还拥有各自明确的 skill。如果用户的请求与其中某项高度匹配,应优先直接调用;它会锁定准确的 skillId,通常还会提供现成的示例 brief,从而避免不必要的猜测。否则,请自行遵循下面的流程。
/open-design:<id>所有 Open Design 内容(skill/template 文本、design system tokens、示例 brief)都通过下面的 MCP 工具调用以纯文本形式提供给你,而不会以文件路径形式提供。你永远不需要,也不应该在磁盘上的任何位置浏览或搜索 Open Design 自身的文件; 和 已经会将以纯文本形式返回所需的一切内容。
<!-- voice:start -->
list_open_design_skillsprepare_open_design_brief如何与用户沟通。 许多使用 Open Design 的人不写代码,因此:
- 使用用户自己的措辞。如果用户说了“artifact”“design tokens”或给出了一个文件路径,请沿用这些术语;否则使用下面的通俗说法。
- 回复中不要暴露内部机制:不要提及工具名称、不要出现 之类的 id、不要提及内部文件(
od:prototype:poster-hero、.artifact.json、.comments.json),也不要使用“register”“manifest”“sidecar”“entry”或“surface”等词,除非用户先使用了这些词。config.json - 印刷术语第一次出现时,用一个简短从句进行解释,之后不再重复。
- 说明用户会在哪里找到文件(例如“在你的 Open Design 文件夹下的 seed-swap-flyer 中”)。只有在用户可以点击文件路径(Claude Code、Claude Desktop 的 Code 标签页、VS Code)或用户主动要求时,才提供原始路径。
- 每个完成某一步骤的回复,都应以一行说明用户接下来可以做什么,并且最多提供两个选项(例如“还需要 Instagram 尺寸的版本,还是已经可以印刷了?”)。
| 不要使用 | 改为使用 |
|---|---|
| artifact、entry、registered | 你的设计,已保存 |
| design system、active design system | 你的风格(第一次提到时说:“一套已保存的样式:颜色、字体和间距”) |
| surface、skill、template、recipe | 设计类型、起始布局,或不提及 |
| workspace、output directory | 你的文件夹、你的 Open Design 文件夹 |
| bleed | 印刷边缘(“多出几毫米、供印刷时裁切的部分”) |
| trim size | 最终尺寸 |
| preflight findings、errors | “我已经检查并修复了……”、“有一点需要留意:” |
| export | 保存为 PDF、保存为图片 |
| inline preview、MCP App | 上方预览 |
请遵循以下流程:
-
检查工具是否已连接。 此 skill 本身无法执行任何操作——下面的每个步骤都需要调用MCP server 提供的工具。如果你当前无法使用
open-design(或下文提到的任何其他工具),说明该 server 尚未在当前项目中注册。请先完成设置,然后从步骤 1 重新尝试:list_open_design_skills-
**Claude Code:**引导用户查看 Claude Code 中的设置步骤。
-
**Codex CLI:**引导用户查看 Codex 中的设置步骤。
-
**其他支持 MCP 的 agent(Cursor 等):**引导用户查看 Getting started,其中说明了如何将 Open Design MCP server 添加到任意 agent。
-
Claude Desktop Chat 或 claude.ai(聊天中没有 Open Design 工具):此时不要创建任何内容。使用通俗语言按以下形式欢迎用户:Open Design 目前无法在此聊天中保存或检查设计。可以通过两种方式解决:
- **连接文件夹:**创建一个名为“Open Design”的文件夹(例如放在 Documents 中),然后点击此聊天中的 +,选择 Add folder,然后选中该文件夹。
- **为 Claude Desktop 安装 Open Design 扩展:**从 https://github.com/feimacode/open-design-agent-kit/releases/latest 下载文件,双击该文件,然后开始一段新聊天。
你想设计什么?在这段话中不要提及文件类型、软件包、命令或工具名称。将步骤 1 中的目标作为用户可以表达的示例(“推广一场活动”、“展示一个想法”、“获得工作机会”)。只有当用户明确表示不采用上述任何方式但仍想继续时,才使用你自己的 Artifact 工具创建并发布一个自包含的 HTML 页面,同时说明它无法使用已保存的样式、无法进行检查,也无法保存为 PDF 或图片。
如果你拥有 shell 访问权限,请自行运行命令;否则,告诉用户需要运行的确切命令,并等待用户确认后再继续。工具可用后,直接跳过此步骤。在 Claude Desktop 中(聊天会话或用户已连接文件夹的 Cowork 会话),server 会在用户的计算机上运行,并从用户的主文件夹启动,而你的文件工具会在另一个路径下看到该文件夹。在调用任何其他 Open Design 工具之前,先调用,并传入该文件夹在用户计算机上的路径(即set_open_design_workspace在get_device_info下列出的路径)。其他工具返回的所有路径都相对于该文件夹:读写文件时,应将该路径拼接到你看到的文件夹路径上;附加或显示文件时,应提供完整路径,因为相对路径会根据 shell 当前目录进行解析,而该目录会随connectedFolders发生变化。如果某个工具提示自己将在主文件夹中工作,它需要的就是这个文件夹。首次在聊天中设置文件夹时,用一句话告诉用户设计将保存在哪里(文件夹名称及其内部的cd文件夹),并说明用户随时可以打开;后续设计无需重复。Open Design在未连接文件夹的 Claude Desktop Chat 中(你的工具中存在),你自己的文件工具无法访问 server 的文件(即使存在此类工具)。先调用use_open_design_managed_workspace,为设计提供一个简短名称,并用一句话告知用户其结果中给出的文件夹绝对路径(默认位于use_open_design_managed_workspace下),以便用户打开。随后,使用~/Documents/Open Design/保存每个设计文件(每次写入完整文件,并放在输出目录下),不要使用自己的文件工具;然后照常注册、检查和导出。调用write_open_design_file一次以显示设计;后续轮次会自动更新该内联副本。不要在这里为每一轮单独保留 Claude artifact 预览。托管文件夹是唯一可信来源:要修改设计,请通过show_open_design_artifact发送完整的新文件。如果聊天中已连接文件夹,则改用write_open_design_file。set_open_design_workspace -
-
调用(可选择传入
list_open_design_skills和/或准确的query),查找与用户需求匹配的 skill 或 design template。根据名称、描述和触发条件选择最佳匹配项。如果某个结果包含mode且与用户需求高度契合,应优先在适配用户具体需求后使用该示例,而不是自行编写 brief。examplePrompt -
项目中持久化存在一个active design system,保存在本地文件中。如果用户提到了品牌、公司、行业或与当前 active design system 不同的视觉风格,请调用
.open-design/config.json(可选择传入list_open_design_design_systems和/或准确的query——首先不传参数以查看分类,并检查每个结果的category标记)来寻找合适的 design system,并将其 id 明确传给active;这样它也会成为此后该项目中默认使用的新 active design system,因此后续请求无需再次指定。对于手机屏幕(Mobile app surface,或类似“感觉像 Monzo 的记账 app”之类的 brief),请先查看prepare_open_design_brief分类,并以 app 名称作为Mobile Apps:这些 design systems 根据真实的 iOS app 进行了调整(标签栏、底部面板、iOS 字号)。手机屏幕应使用query(例如<app>-ios),即使同名品牌也存在 web design system(如spotify-ios);web 页面仍应使用 web 版本。如果用户没有提出任何方向且已有 active design system,只需在spotify中省略prepare_open_design_brief,它会使用当前 active design system。如果没有 active design system,且用户也没有指定方向,请在准备新设计之前先推荐一个(编辑、remix 或导出除外):调用designSystemId,根据请求、对话和 workspace 中已知的信息传入recommend_open_design_design_systems、industries、moods、theme、surface、likeBrands,未知项不要填写。如果结果包含brief,应一次性以简短的多选项形式询问:工具中存在questions时使用该工具,否则在一条消息中询问(或使用宿主提供的 question 工具),并允许用户选择“你来定”;收到答案后再次调用该工具。如果还要询问 surface 问题,应在同一条消息中提出,总问题数最多为三个。展示推荐列表:工具中存在show_open_design_questions时传入推荐的show_open_design_design_systems;否则用简短编号列表展示每个名称及其理由。无需再等待一次明确选择:直接采用第一个推荐,将其 id 传给ids,并告诉用户使用了哪种风格,同时说明用户可以改选。如果工具中没有prepare_open_design_brief,则改用recommend_open_design_design_systems,或者不指定 design system。只有当用户希望在生成任何内容前固定某种外观时(例如“以后都使用 Starbucks 的风格”),才直接调用list_open_design_design_systems。set_active_design_system -
调用,传入选定的
prepare_open_design_brief、可选的skillId(按步骤 2 确定)以及用户的designSystemId(用用户自己的原话表述)。它会返回需要遵循的brief、instructions,以及实际使用的suggestedEntryPath/designSystemId(无论是显式指定还是使用默认值);如果从对话中无法明显看出使用了哪个 design system,应说明这一点。该工具不会写入任何文件。designSystemName -
遵循返回的,使用你自己的文件编辑工具亲自创作 artifact 的入口文件(以及所有支持文件)。不要寻找其他单独的工具来写入设计内容。
instructions -
调用,传入入口路径、
register_open_design_artifact、kind和所有title,以便系统识别该 artifact 并为其写入 manifest sidecar。supportingFiles -
在告诉用户完成之前,调用并传入入口路径(创建 artifact 后执行一次,进行实质性编辑后再次执行)。它会渲染 artifact,并返回截图和 preflight findings:修复每一个 error,然后查看截图,找出检查工具无法衡量的问题——平衡、层级、拥挤或空洞的区域、文字压在繁忙图像之上等——并修复明显有误之处。审美警告(
check_open_design_artifact、slop-glow、card-row、uniform-surface、type-scale)也值得检查:除非 brief 或 design system 明确要求这种效果,否则应予以修复;绝不能仅为了消除警告而添加intent。修复后重新检查,但最多进行两轮修复;如果仍有遗留问题,应告知用户。**随后,在宣布完成前再获取一次独立意见:**检查结果干净或修复轮次用尽后,运行data-od-allowskill,让一名全新的 critic 根据 brief 和 design system 对最新一次检查进行评判,涵盖目的与层级、排版、颜色与对比度、布局与节奏、文案、状态和适配度;构建时就应考虑这些方面。只进行一轮 critique:如果结果为open-design-critique,应用其修复建议一次,重新注册并检查,然后报告完成,不再进行另一轮 critique;如果结果为polish,告诉用户存在的问题,并在重建前征求同意;如果结果为rework,则已经完成。brief 或 design system 的要求优先于与指定风格相冲突的评审意见,用户可以随时要求另一轮意见,也可以表示不需要。**3D 设计是例外:**当检查返回 3D review sheet 时,检查结果干净并不代表结束。按检查结果要求获取 critique(shipskill 的评分表;如果宿主支持,则使用 subagent),然后修复、重新检查并重新 critique,最多进行三轮 critique;这些轮次取代前述两轮修复上限和额外意见环节。除非用户主动询问,否则不要向用户描述截图:每次运行的截图都会保存供用户查看,浏览器预览的 Checks 面板会在修改前后展示它们(结果中也会列出保存路径)。如果返回3d-object,跳过检查,并告知用户一次:视觉检查需要安装 Chrome、Edge 或 Chromium。no-browser -
可以选择调用,确认已写入的内容,然后再告诉用户完成。
get_open_design_artifact -
在会话中首次注册 artifact 后,除非用户明确表示不需要预览,否则调用并传入其入口路径。它会打开实时浏览器预览,并在文件发生变化时自动重新加载,因此编辑后不要再次调用;只有切换到另一个 artifact 时才再次调用。告诉用户可以点击预览中的 Comment 为元素留下评论。
open_open_design_preview在 Claude Desktop 的 Code 标签页中(其预览工具名称类似),使用 Browser 面板而不是单独的窗口:会话中第一次显示设计时,调用preview_start(每个项目一次;用一句话告诉用户,已在set_up_open_design_browser_pane中添加一个预览入口),然后使用该预览工具启动它指定的.claude/launch.json配置。面板会打开最新注册的设计,并在文件变化时重新加载。对于后续设计,请重新加载面板(如果预览工具支持),或者告诉用户该设计已出现在面板列表中。如果面板无法启动,则回退到open-design-preview。open_open_design_preview在 Claude Desktop Chat 中(聊天对话,而非 Code 标签页或终端),改为调用并传入入口路径:它会在对话中内联显示设计,用户可以发表评论并点击 Ask Claude to apply。每个设计在首次调用show_open_design_artifact后调用一次:该副本会自动跟踪后续编辑和已应用的评论,因此除非用户要求,不要再次显示同一设计。注册结果会说明当前宿主支持哪种方式。如果结果提示宿主无法显示 MCP Apps,则回退到上述register_open_design_artifact。它的导出按钮会在聊天中发来请求:运行open_open_design_preview并使用按钮指定的格式,然后告知用户文件路径。对于 exploration,传入export_open_design_artifact以并排展示各个方向;当用户通过 Take this one 选择后,先询问下一步想做什么,再调用explorationId。style-tile exploration 还会提供 Use as design system,此时直接调用choose_open_design_direction,并设置choose_open_design_direction。next: "save-design-system"在 Claude Desktop Chat 中通过视觉方式选择。 以下两个工具仅在宿主支持内联显示 MCP Apps 时才会列出,因此只有工具列表中确实存在时才使用:会以实时预览图库的形式展示可 remix 的示例,可按show_open_design_examples、query或mode筛选;surface会以图块形式展示 design systems,并接受show_open_design_design_systems以显示候选列表。当用户希望选择起始示例或品牌风格,但尚未指定具体选项时,使用这些工具。用户的选择会以聊天消息的形式返回,并注明要调用的工具:“Remix this”表示对带有ids的条目调用skillId(如果用户还没说想做什么,先询问);“Use this design system”表示调用remix_open_design_example并传入该 id。在其他环境中,继续使用set_active_design_system和list_open_design_skills。list_open_design_design_systems链接到公开图库。 有些结果会带有 Open Design 图库链接。该图库是一个展示所有示例和 design systems 的网站:图库 url 来自和show_open_design_examples的show_open_design_design_systems,design system url 来自gallery.url的register_open_design_artifact。这些链接仅在图库在线时出现;绝不要自行编写图库链接。当用户正在浏览时(想先看看再决定,例如“给我看一些示例”、“有哪些风格?”或“咖啡馆菜单可以有哪些创意?”),如果工具支持,就在聊天中显示图库,然后添加一行designSystem.galleryUrl链接(“可在 Open Design 图库 中查看全部内容。”),除非本次对话中已经提供过该链接。当设计准备就绪且注册结果包含gallery.url时,应在宣布准备就绪的那句话中带上链接并注明 design system(例如“它使用了 Kami design system。”);同一对话中首次使用该 design system 时这样做即可,后续轮次或使用相同风格的其他设计无需重复。在用户提出具体请求之前(例如“设计一张周六种子交换活动海报”),在导出或发布之后,或者在定期任务运行中,绝不要链接图库。designSystem.galleryUrl在 Claude Desktop Chat 中通过点击操作提问。 只有当出现在工具列表中时,才使用它;此时所有简短多选问题都应通过该工具提出,而不是在聊天消息中提出。构建前询问 surface 和 design-system 问题,exploration 后询问方向问题,review 后询问“是否修复这些问题?”。最多四个问题,每个问题包含简短的show_open_design_questions、id、text(kind、single或multi)以及最多八个text;选项可以携带options(imageRef、designSystem:<id>、example:<skillId>或artifact:<entryPath>),但绝不能使用 URL。不要在聊天中重复这些问题。答案会以一条以checkRun:<entryPath>开头的消息返回,并包含一行Answers::读取其中的 JSON(问题 id 对应选项 id,<!-- od-answers {...} -->对应数组,文本类型对应输入文本,multi表示由你代为选择并说明选择结果)。也接受用户输入的文字答案。artifact 视图下方还有三个快捷回复(“Looks good”、“Change something”、“Try another direction”);每个回复都会发布一条说明下一步操作的消息。在其他环境中,应在一条聊天消息中提出所有问题。you-pick
当请求说明了设计用途但没有说明要制作什么时(“帮我们推广种子交换活动”、“做点能帮我获得 UX 工作机会的东西”),或者请求过于模糊、无法判断时,使用 调用 :其 是用通俗语言描述的目标(推广活动、展示想法、获得工作机会等)。选择符合要求的目标,或者展示这些目标(名称和描述)并询问一个问题:“这是用来做什么的?”。随后将该目标的 id 作为 再次调用,并以 标记 surface;仅当请求本身无法确定具体形式且该目标对应多个选项时,才进一步询问用户。不要向用户展示 surface 列表,除非他们询问可以制作哪些类型的内容。
surface: "list"list_open_design_skillsgoalsgoaldefault当请求明确指出了要制作的种类时(原型或落地页、app 屏幕(产品中的设置页、表格、表单、搜索页或详情页,或登录、引导、付费墙、设置流程:应使用 surface ,而不是 )、移动 app、幻灯片、文档、线框图、动画、简历、研究综述、数据报告、海报或传单、社交帖子、图表、3D 对象),首先使用相应的 调用 (使用 可以查看 ids)。从结果中选择合适条目;如果该 surface 指定了某个 prompt,应遵循该 prompt。**问题:**每个 surface 会列出少量 ,每个问题都包含 、 以及回答会改变的 字段。只询问请求、对话和 workspace 尚未回答的问题:与 design-system 推荐器的问题合并后,总数最多三个,并在一条消息中以多选形式提出,允许用户选择“你来定”(此时使用该问题的 )。如果请求本身已经足够明确,则不要提问。将答案作为 (问题 id 到答案的映射)传给 ,将无需询问便自行决定的内容作为 (最多六条简短说明)传入;然后在调用 时,将二者连同用户请求的单行文本一起作为 传入。设计准备就绪后,用一句话列出所做的假设,并邀请用户提出修改(“我采用了深色主题和一个注册按钮;如果你想要其他效果,请告诉我。”)。如果用户明确要求某一个特定 template 或 style,仍应直接使用它。绝不要选择标记为 的条目;它只是在宣传上游 skill,本身不包含任何 instructions。
app-screensprototypesurfacelist_open_design_skillssurface: "list"questionsoptionsdefaultchangesdefaultanswersprepare_open_design_briefassumptionsregister_open_design_artifactbriefstub: true对于工程文档(RFC、ADR、postmortem、PR 变更说明或 changelog 页面),使用匹配的 skill(、、、、)。先自行收集事实,来源包括 git(、)和相关文件,并将读取到的内容注册为 。绝不要虚构事故事实、日期或数字:应向用户询问。要将一个 Markdown 文档文件夹转换为页面,请遵循 docs flow(加载 skill):每个文件对应一个页面,整组页面使用同一个 template,重新运行时仅处理 Markdown 已发生变化的页面。
od:prototype:rfcadrpostmortempr-explainerchangelog-pagegit loggit diffsourcesopen-design-docs对于定期设计(“每周”、“按计划”、“每月根据新数据”)或提示中写着“Run the Open Design job <path>”的请求,请加载 skill:job 位于 ,每次运行都先调用 (如果返回 则停止),最后调用 ;job 运行绝不会公开发布,也不会发布到社交网络。
open-design-recurring.open-design/jobs/<id>.job.mdstart_open_design_job_runskipfinish_open_design_job_run如果请求基于某个文档(提到或附上报告、spec、spreadsheet、PDF、现有 deck,或者指向 repository 文件,如 、、RFC 或 metrics CSV),应基于该文档生成,而不是凭记忆生成:将这些 workspace 路径作为 传给 。典型示例包括“根据 CHANGELOG.md 制作发布 deck”、“根据 docs/adr/ 制作架构评审”、“根据 metrics/q3.xlsx 制作董事会更新”、“把 docs/q3-report.docx 变成 pitch”。该工具会将各类文档(DOCX、PPTX、XLSX、通过 处理的 PDF、Markdown、文本、CSV)提取为 Markdown,并返回 instructions,要求你先编写 outline 并停下来等待用户批准,然后再进行构建。遵循这些 instructions:按行范围读取提取出的文本,编写 ,向用户展示并等待确认(除非用户明确表示直接构建)。随后使用相同的 注册;结果会列出页面上无法在 sources 中找到的数字,因此应逐一检查和修复。可以单独使用 查看文档内容,再决定如何使用。对于整个文件文件夹(如 ),请逐个传入相关文件(最多 10 个)。
CHANGELOG.mddocs/adr/sourcesprepare_open_design_briefpdftotextoutline.mdsourcesread_open_design_sourcedocs/adr/当用户希望选择颜色和字体、配色方案、字体搭配,或为新品牌确定风格(“给我看看颜色和字体方案”、“我们的品牌可以是什么样子?”),请使用 style-tile skill()运行 exploration:它会生成紧凑的图块(包含对比度的调色板、字体样张和组件),而不是完整页面,默认生成 4 个。如果要在 active design system 的基础上变化,而不是替换它(例如“同样的风格,但更温暖”),使用 ,并为每种变化指定一个方向。用户选定某个图块后,调用 并设置 :该图块的 tokens 会被原样复制到新的 design system 中,随后它会成为 active design system。
skillId: "od:design-system:style-tile"axis: "custom"choose_open_design_directionnext: "save-design-system"如果用户明确要求比较多个选项(“为……展示三个方向”、“做几个不同版本”、“我不确定想要什么风格,给我一些选项”),请运行 design exploration,而不是执行步骤 3–5。不要为普通请求进行 exploration(例如“设计一个定价页面”),因为这需要多次生成。
- 调用 ,传入
prepare_open_design_exploration和用户的skillId(如果用户指定了数量,再传入brief2–4,默认 3)。该工具会自行选择有明显差异的方向:没有 active design system 时选择视觉风格,有 active design system 时选择布局或叙事结构(从而保留品牌);如果用户明确指出需要变化的内容,则传入count和axis: "custom"(例如“三个 hero 概念”)。只有当 brief 的语气明确要求特定方向时,才传入customDirections(例如杂志使用directionIds,艺术或代理类网站使用editorial-monocle)。如果结果说明 active design system 已被暂时搁置,应告知用户。brutalist-experimental - 对于每个返回的方向,先遵循 ,再遵循该方向自己的
sharedInstructions,将其文件写入instructions,并调用suggestedEntryPath,传入register_open_design_artifact和该方向的explorationId。这些方向只是快速 sketch(一个屏幕,或一张封面加两张幻灯片),不是完整构建。如果可以委派工作给 sub-agents,可并行生成各个方向,并分别向其传递directionId和该方向自己的sharedInstructions。instructions - 调用 ,并设置
compare_open_design_exploration。如果可以查看图片,请打开 contact sheet,检查这些方向是否确实存在明显差异(布局和 hero 模式,而不只是颜色);如果某个方向与另一个过于相似,请重新生成。contactSheet: true - 将 comparison page 路径(;可直接从文件系统在浏览器中打开,并并排显示所有方向)和 contact sheet 路径分别放在单独一行,简要说明每个方向有何差异,并通过
compareFile(工具中存在时)询问用户想采用哪个方向,每个方向作为一个选项,并设置show_open_design_questions。imageRef: "artifact:<其 entry path>" - 用户选定后,调用 并设置
choose_open_design_direction:next(将选中的 sketch 完成为高保真成品)、build-out(同样完成构建,但通过merge吸收其他方向中指定的特性,例如“B 加上 A 的 hero”)或mergeFrom(将该方向转换为可复用的自定义 design system)。遵循返回的 instructions,并按照其中的要求注册结果。save-design-system
生成的 artifacts 会放在项目的 Open Design 输出目录下(默认 ),以便像其他项目文件一样在版本控制中保持可见且可追踪。注册或更新 artifact 后,应在单独一行告诉用户写入位置及其相对于 workspace 的入口路径(例如 ):在 Claude Desktop 的 Code 标签页中,点击该路径会在 Browser 面板中打开。不要自行在浏览器中打开 HTML 文件:应使用 (或 Claude Desktop Chat 中的 )进行展示。
.open-design/.open-design/coffee-poster/coffee-poster.htmlopen_open_design_previewshow_open_design_artifact来自预览的评论。 当用户表示留下了评论(或粘贴预览中的“Apply my comments”指令,或内联预览发布了该指令)时,为对应入口调用 。其 会列出每条评论的备注及其指向的元素(、、、);最多会附加 4 个被评论元素的截图,并列出每条评论的 路径。仅使用自己的文件编辑工具修改这些元素,然后再次调用 ,并传入这些评论的 ids 作为 ,使预览中的评论标记消失;然后按照步骤 6 执行检查。在 Claude Desktop Chat 中,内联副本会自动更新;只需告诉用户设计已更新,不要再次显示。
get_open_design_artifactopenCommentsselectortexthtmlHintrectscreenshotregister_open_design_artifactresolvedCommentIds如果用户希望从现有示例开始或基于示例改造,应优先使用 (skillId 必须是 的条目),而不是 ;它会将一个可用的起始 artifact 复制到项目中,并提示你修改它,而不是从头重新生成。可 remix 示例的完整列表见 references/remixable-examples.md,按 mode 分组;在调用带 的 之前,如果快速浏览该列表已经能回答问题,应先查看它。
remix_open_design_exampleremixable: trueprepare_open_design_briefremixableOnly: truelist_open_design_skills如果用户需要使用不在约 150 套内置 design systems 中的品牌或风格(例如“使用我们自己的品牌颜色”、“匹配我们的网站”、“为……设置自定义 design system”),请调用 ,传入 、描述品牌的 ,以及用户提供了网站时的可选 。它会返回编写新 所需的 instructions(文件结构与每套内置 design system 相同);如果提供了 ,还会尽力提取一份初始调色板/字体列表供你参考——应将其视为粗略起点,而不是事实依据。该工具不会写入任何文件。写好文件后,使用返回的 id 调用 ;design system 不需要单独的注册步骤,写好的 会立即变为可选状态,就像生成并写入的 artifact 会立即可见一样。
create_open_design_design_systemnamebriefsourceUrlDESIGN.mdsourceUrlset_active_design_systemDESIGN.md当用户对生成或修改后的 artifact 满意,并希望将其转换为当前 app 中真正可运行的代码(例如“把它变成真正的组件”、“把它加入这个 app”、“接入我的 codebase”),请使用 artifact 的 调用 。它会返回 instructions,用于在当前项目的真实应用中复现该 artifact 的设计:仔细阅读这些 instructions;它们会要求你查找并遵循 codebase 中真实存在的组件作为模式参考,包括其样式方案、约定和文件组织方式,而不是逐字复制 artifact 的 HTML/CSS,并将路由/导航接入作为独立步骤留给用户。该工具本身不会写入任何文件。
entryPathport_open_design_artifact_to_app与 Impeccable 配合。 移植完成后,如果自己的 skill 列表中存在名为 的 skill,请在回复结尾建议对刚编写的组件运行 (或 )。如果没有该 skill,则不要提及 Impeccable。在代码项目中,如果已经为项目设置了 design system,但项目中没有 ,可以一次性询问是否将其保存为项目的 ,以便其他工具读取;用户同意后,再次调用 并设置 (它绝不会覆盖已有文件)。
impeccable/impeccable polish/impeccable auditDESIGN.mdDESIGN.mdset_active_design_systemwriteProjectDesignMd: true当用户需要的是可复用组件,而不是 app 中的单个页面(例如“为我的 React app 制作 Material 3 组件”、“根据这个设计制作一套组件库(用于这些屏幕)”),请改为调用 ,传入 artifact 的 (如果每个屏幕都有 ,则传入它)以及 (、 或 )。严格按顺序执行各阶段:先编写 清单,并在编写任何代码之前停下来等待用户明确同意;使用生成的 theme;包装该库自身的组件;添加 gallery;运行 app 的类型检查;然后再次调用该工具并设置 。该工具本身不会写入 app 代码。“Material 3”对应 。
prepare_open_design_component_libraryentryPathscollectionIdlibrarymuishadcnautocomponents.mdrecordmui当 artifact 需要作为图片发布或上传时(X/Twitter 帖子、Instagram 或 LinkedIn 图片、小红书卡片、YouTube 缩略图、海报),注册后调用 并传入其 。它会在无头浏览器中渲染 artifact,并将 PNG/JPEG 文件写入 artifact 自己的 文件夹;除非传入 /,否则尺寸由 source skill 自动决定。对于多卡片设计,为每张卡片添加 属性,并传入 ,从而为每张卡片生成一张带编号的图片。传入 以匹配平台的上传限制(X 5000000、YouTube 缩略图 2000000、Instagram 8000000)。告知用户导出文件的路径。对于任何社交帖子请求(“制作一条 X 帖子……”、“制作一个 Instagram 轮播图……”、“制作一个 YouTube 缩略图……”),必须先加载 skill。它会将每个平台和格式映射到正确的画布尺寸、skillId 和导出参数(平台不明确时会询问用户),然后引导完成生成 → 注册 → 导出。动画设计(动态帧、标题卡、动态图表、精灵图或 WebGL 动画)应导出为视频或 GIF:调用 ,设置 、 或 。时间按虚拟时钟运行,因此帧精确且每次运行结果一致;时长来自页面( 帧数或最长动画),除非另行传入 。导出前,调用 并设置 (例如 ),以查看开头、中间和结尾。导出需要安装 ffmpeg:如果报告 或 ,应告诉用户需要安装什么,不要自行尝试其他替代方式。使用 HyperFrames framework 构建的组合是例外:其 brief 自身的 instructions 会要求使用 HyperFrames CLI 进行渲染。注册 slide deck 后,应主动询问是否需要导出为 PowerPoint 或 PDF;用户需要时,调用 并设置 或 (PPTX 中每张幻灯片都是一张铺满页面的图片:效果精确,但不可编辑)。如果用户需要可在 PowerPoint、Keynote、Google Slides 或 Canva 中编辑的幻灯片,请在 导出时添加 :文本框、形状和图片可以修改,效果与原 deck 接近但不完全一致,渐变、SVG 图表和特殊效果会作为背景图片保留。告诉用户哪些内容会保留为图片,以及需要安装哪些字体。绝不要自行编写转换脚本。普通页面设置 时,会打印为矢量 PDF。
export_open_design_artifactentryPathexports/widthheightdata-od-cardselector: "[data-od-card]"maxBytesopen-design-social-postexport_open_design_artifactformat: "mp4""webm""gif"data-durationdurationcheck_open_design_artifactat[0, 1.5, 3]no-ffmpegffmpeg-missing-encoderexport_open_design_artifactformat: "pptx""pdf"pptxeditable: trueformat: "pdf"对于展示系统关系的图表——架构、依赖关系、请求流程、数据库 schema(ERD)、状态机或调用时序(“绘制我们的服务如何通信”、“画出 schema”、“结账流程如何运作?”)——请使用 skill(,或 remix 其示例 )。先阅读相关代码,并且只绘制实际读到的内容。使用 / 和隐藏链接编写节点,绝不要使用坐标;然后调用 (它会插入布局 runtime,绝不要自行编写该脚本),使用 kind 和已读取的文件作为 进行注册,并执行检查。如果后续检查或 报告 sources 已发生变化,应主动提出重新绘制。
diagramod:prototype:diagramod:prototype:diagram:exampledata-rankdata-laneadd_open_design_diagram_runtimediagramsourcesget_open_design_artifact对于 3D 对象——产品图、3D logo、旋转展示,或用户自己的 / 模型(“为我们的瓶子制作 3D 渲染”、“把 logo 变成 3D”、“为 models/headphones.glb 制作产品图”)——请使用 skill()。它会创建一个 three.js 场景,包含影棚灯光、来自 design system tokens 的材质、地面阴影和旋转展示装置。严格按照 skill 的说明加载 three.js(使用其针对固定版本 模块构建的 import map):旧版 和 script 标签已不存在,使用它们会导致页面空白。将用户模型复制到设计旁边的 下,并使用 加载,根据模型边界框调整相机取景。页面必须公开 (包含 ,并在所有内容加载后完成一次直接渲染后解析为 true,以及 );导出和检查会启用软件 WebGL 并等待其就绪。导出前修复 findings。如果需要制作可放置到幻灯片或页面中的镂空对象,从无背景的场景导出 并设置 ;如果需要旋转展示,则导出 或 ,并将 设为一圈旋转的时长。
.glb.gltf3d-objectod:prototype:3d-objectthree@0.160.0three.min.jsexamples/jsassets/GLTFLoaderwindow.odScenereadyrotatewebglformat: "png"transparent: trueformat: "mp4""gif"duration对于 HTML 邮件(newsletter、发布通知或产品更新邮件),使用 skill:它会构建基于 table、适合邮件客户端安全渲染的邮件,并标记 。完成检查后,调用 并设置 ;用户将 文件夹托管后,添加一次 ,使图片 URL 变为绝对路径;并提醒用户先给自己发送一封测试邮件,再发送给邮件列表。如果用户希望将设计粘贴到其他编辑器(微信公众号文章、Notion 页面、newsletter 工具),导出时设置 ,并设置 为 、、 或 ;样式会从浏览器渲染结果中内联化。使用生成的文件时,用户需在浏览器中打开、全选并复制。
email-campaigndata-od-emailexport_open_design_artifactformat: "email"assets/baseUrlformat: "paste"targetwechatnotionnewslettergeneric对于 campaign(一条信息覆盖多个渠道或尺寸、多个尺寸的广告横幅,或相同创意使用多种语言),必须先加载 skill:先就 CSV 保存的 copy deck 达成一致,构建一个使用 绑定到该 deck 的流式主设计(将 headline 和 subhead 标记为 ,以适应较长的翻译),按行检查每个选定尺寸,然后导出时传入 、 和 。
open-design-campaigndata-od-fielddata-od-fitpresetsdatacampaignSheet: true对于海报、传单、证书或其他印刷品,或者当用户希望将现有设计转换为其他尺寸或打印就绪 PDF 时,必须先加载 skill。简要流程:如果尚不明确,先询问是印刷还是屏幕展示以及尺寸;将画布 (例如 、、、)与 一起传给 ,并将相同 传给 (流式海报可适配任何形状,因此后续可以更改尺寸);任何 QR code 都应使用 制作,绝不能画一个假的;运行 并修复所有 preflight error;然后导出时设置 为对应的 format id(印刷格式会生成包含 bleed、trim 和 bleed boxes 的 PDF)。 可一次导出多种尺寸, 会将它们显示在同一张图片中; 可以调整看起来不合适的形状(对于流式海报会就地调整);导出参数中的 会为用户 spreadsheet 中的每一行生成一个文件。印刷 PDF 使用 RGB,应明确告知用户。
open-design-posterformata3a2ig-portraitstoryfluid: trueprepare_open_design_briefformatregister_open_design_artifactcreate_open_design_qr_codecheck_open_design_artifactpresetpresetsshapeSheet: trueadapt_open_design_artifactdata当用户希望与没有打开当前项目的人分享设计时:如果需要链接(“发布这个”、“部署它”、“给我一个可以发给团队的链接”、“托管到某个地方”),调用 并传入其 (只有当用户已经明确指定托管位置时才传 ;否则工具会返回可供用户选择的选项)。它会构建一个可直接部署的文件夹,并返回在用户自己的 CLI 登录环境中通过终端执行的详细说明,或者提供一个临时的免账号链接。必须严格遵循这些说明:任何内容上线前都要等待用户明确同意;成功部署后,再次调用该工具并设置 以记录链接。如果用户只需要附加或发送单个文件(“把它导出为一个 HTML 文件”),则调用 并设置 ,不会将任何内容发布到线上。 skill 会引导完成整个流程。
publish_open_design_artifactentryPathproviderpublishedexport_open_design_artifactformat: "standalone"open-design-publish对于 Figma:如果要将 frame 转换为代码,调用 并传入 frame 链接(“Copy link to selection”);如果要将完成的设计作为可编辑图层放入 Figma,调用 并传入其 。两者都通过用户的 Figma 连接工作;如果不可用,则回退到 Figma 导入插件。
pull_open_design_figma_framepush_open_design_artifact_to_figmaentryPath当某一步需要将工作移交给其他服务时(导入 Canva、读取或推送 Figma frame、保存到 Google Drive、编写 Notion 页面、分享到 Slack,或发布到社交网络),先使用相应的 调用 (社交帖子还需传入 )。然后:
capabilitylist_open_design_integrationsplatform- 检查自己的工具中是否有与返回模式匹配的工具,包括可以搜索的 deferred 或 on-demand 工具。如果存在,则使用它,并调用其 server 定义的名称(例如 Canva 的 )。
import-design-from-url - 如果不存在,则提议配置第一个 provider;每次对话最多提议一次,并且仅在当前步骤确实需要时提议:说明该 provider 的作用及其登录要求。只有用户明确同意后,才遵循返回的设置步骤(仅进行用户级配置)。绝不要静默安装,也绝不要索要 API key 或将 API key 写入文件;用户应自行设置。
- 帮助用户登录,并在需要时重新加载,然后通过列出工具进行确认。
- 如果用户拒绝配置或配置失败,则继续采用该工作流的手动路径。
任何会以用户账户发布、发送或投稿的内容,仍必须事先获得用户同意。
Help
帮助
When the user asks how something works, or a tool reports an error, point them to the relevant page:
- Documentation index: https://github.com/feimacode/open-design-agent-kit/blob/main/docs/README.md
- Troubleshooting (export errors, missing browser or FFmpeg, blank slides, MCP connection): https://github.com/feimacode/open-design-agent-kit/blob/main/docs/troubleshooting.md
- Exploring design directions: https://github.com/feimacode/open-design-agent-kit/blob/main/docs/guides/explore-directions.md
- Turning a document into a deck: https://github.com/feimacode/open-design-agent-kit/blob/main/docs/guides/deck-from-a-document.md
- Sharing and publishing: https://github.com/feimacode/open-design-agent-kit/blob/main/docs/guides/share-and-publish.md
- Connecting Canva, Figma, Notion, Google Drive, Slack or a posting service: https://github.com/feimacode/open-design-agent-kit/blob/main/docs/guides/integrations.md
- Social media posts: https://github.com/feimacode/open-design-agent-kit/blob/main/docs/guides/social-posts.md
- Posters and print: https://github.com/feimacode/open-design-agent-kit/blob/main/docs/guides/posters.md
- Export images: https://github.com/feimacode/open-design-agent-kit/blob/main/docs/guides/export-images.md · Export decks and PDFs: https://github.com/feimacode/open-design-agent-kit/blob/main/docs/guides/export-decks.md
- Tools reference: https://github.com/feimacode/open-design-agent-kit/blob/main/docs/reference/tools.md
当用户询问某项功能如何工作,或工具报告错误时,请指向相关页面:
- 文档索引:https://github.com/feimacode/open-design-agent-kit/blob/main/docs/README.md
- 故障排查(导出错误、缺少浏览器或 FFmpeg、空白幻灯片、MCP 连接):https://github.com/feimacode/open-design-agent-kit/blob/main/docs/troubleshooting.md
- 探索设计方向:https://github.com/feimacode/open-design-agent-kit/blob/main/docs/guides/explore-directions.md
- 将文档转换为 deck:https://github.com/feimacode/open-design-agent-kit/blob/main/docs/guides/deck-from-a-document.md
- 分享与发布:https://github.com/feimacode/open-design-agent-kit/blob/main/docs/guides/share-and-publish.md
- 连接 Canva、Figma、Notion、Google Drive、Slack 或发布服务:https://github.com/feimacode/open-design-agent-kit/blob/main/docs/guides/integrations.md
- 社交媒体帖子:https://github.com/feimacode/open-design-agent-kit/blob/main/docs/guides/social-posts.md
- 海报与印刷:https://github.com/feimacode/open-design-agent-kit/blob/main/docs/guides/posters.md
- 导出图片:https://github.com/feimacode/open-design-agent-kit/blob/main/docs/guides/export-images.md · 导出 decks 和 PDF:https://github.com/feimacode/open-design-agent-kit/blob/main/docs/guides/export-decks.md
- 工具参考:https://github.com/feimacode/open-design-agent-kit/blob/main/docs/reference/tools.md