stitch-manage-design-system
Manage design systems in Stitch using MCP tools. Includes retrieval of assets, creating/updating design systems in Stitch, and applying them to screens.
- License 许可
- MIT
- 最近更新
- 2026-08-19
- Stars
- ★ 2
- Forks
- 0
01 前言 Front Matter
- description
- Manage design systems in Stitch using MCP tools. Includes retrieval of assets, creating/updating design systems in Stitch, and applying them to screens.
02 资源文件 1
- 参考文档reference/tool-schema.md6.5 KB
03 SKILL.md 正文
Design-System
Create a "source of truth" for your project's design language to ensure consistency across all future screens.
[!NOTE] Refer to your system prompt for instruction on handling MCP tool prefixes for all tools mentioned in this skill (e.g.,
get_screen,create_design_system_from_design_md,apply_design_system).
📥 Retrieval
To analyze a Stitch project, you must retrieve metadata and assets using the Stitch MCP tools:
- Project lookup: Use
list_projectsto find the targetprojectId. - Screen lookup: Use
list_screensfor thatprojectIdto find representative screens (e.g., "Home", "Main Dashboard"). - Metadata fetch: Call
get_screenfor the target screen to getscreenshot.downloadUrlandhtmlCode.downloadUrl. - Asset download: Use
read_url_contentto fetch the HTML code.
🧠 Synthesis from Description
If you need to extract a design system from existing screens, use the design-md skill (in the stitch-utilities plugin).
If there are no existing screens (new project), or the user provides a direct description (e.g., "dark theme, blue and purple, rounded, Inter font"):
- Map the user's vague terms to precise values using the design mappings (see
design-mdskill institch-utilitiesorgenerate-designskill). - Select concrete hex codes, font families, and roundness values.
- Generate the
DESIGN.mdfile (refer to thedesign-mdskill institch-utilitiesfor structure). - Proceed to the "Create or Update Design System in Stitch" step below.
📝 Output Structure
The DESIGN.md file should follow the structure defined in the design-md skill (in the stitch-utilities plugin).
🚀 Create or Update Design System in Stitch
After generating .stitch/DESIGN.md, make sure to also create or update the
design system in Stitch.
Two-step design system creation:
[!WARNING] Checkpoint — User Confirmation Required. Before uploading, you MUST pause and ask the user for confirmation. Present a summary of the design system you are about to create (display name, key colors, fonts, and roundness) and wait for explicit approval before proceeding. Do NOT upload until the user confirms.
- Upload
DESIGN.md:-
Option A (Recommended - Uploader Script): Use the modified
upload-to-stitchPython script which natively handles.mdfiles. It base64-encodes the markdown file in-process and sends it to the/v1/projects/{projectId}/screens:batchCreateendpoint, bypassing output token limits.python3 stitch-skills/plugins/stitch-design/skills/upload-to-stitch/scripts/upload_to_stitch.py \ --project-id <PROJECT_ID> \ --file-path /path/to/DESIGN.md \ --api-key <API_KEY> \ --generated-by <GENERATED_BY>Set
<GENERATED_BY>to identify the skill or tool that produced theDESIGN.md. Use the calling skill name when invoked from another skill (e.g.stitch::code-to-design), or the agent/tool name for standalone use (e.g.Gemini,Claude Code). If omitted, the script defaults toUserUploadedDesignMd.This returns the
sourceScreenID and thescreenInstanceID. -
Option B (Direct MCP Tool): If the
DESIGN.mdis small (under ~5KB), you can call theupload_design_mdMCP tool directly, passing the base64-encoded design markdown content asdesignMdBase64.
-
- Create Design System: Call the
create_design_system_from_design_mdtool immediately after the upload, passing theprojectIdand theselectedScreenInstance(containing theidandsourceScreenreturned from the upload step).
Once the upload script and create_design_system_from_design_md have both completed,
Stitch holds the design tokens at the project level — you do NOT need to repeat
them in generation prompts.
🎨 Apply Design System to Screens
Use apply_design_system to apply a design system to existing screens.
[!IMPORTANT]
selectedScreenInstancesmust contain onlyidandsourceScreen— do NOT include position/dimension fields (x,y,width,height) or the request will fail with "invalid argument". Get the screen instance IDs fromget_project.
{
"projectId": "...",
"assetId": "...",
"selectedScreenInstances": [
{
"id": "...",
"sourceScreen": "projects/.../screens/..."
}
]
}
How to get the required IDs:
- Call
get_projectto retrievescreenInstances— each has anidandsourceScreen. - Call
list_design_systemsto retrieve the design systemname(format:assets/{assetId}) — use the part afterassets/as theassetId. - Filter out any instances with
type: "DESIGN_SYSTEM_INSTANCE"— only pass real screens.
📋 Update Project Metadata
After writing .stitch/DESIGN.md, also create or update .stitch/metadata.json
to track the projectId, title, all known screens, and design system summary.
See examples/metadata.json for the format.
Schema Reference
See reference/tool-schema.md for the full
designSystem object schema with all available options.
💡 Best Practices
Refer to the design-md skill (in the stitch-utilities plugin) for best practices on describing design elements.
04 同仓库更多 Skills
youtube-transcript
Extract transcripts from YouTube videos. Use when the user asks for a transcript, subtitles, or captions of a YouTube video and provides a YouTube URL (youtube.com/watch?v=, youtu.be/, or similar). Supports output with or without timestamps.
youtube-thumbnail-design
YouTube thumbnail design with specific dimensions, contrast rules, and mobile preview optimization. Covers safe zones, text placement, face expression psychology, and A/B testing. Use for: YouTube thumbnails, video cover images, click-through optimization. Triggers: youtube thumbnail, thumbnail design, video thumbnail, click through rate, ctr optimization, youtube cover, video cover image, thumbnail maker, thumbnail tips, youtube design, video preview image
youtube-short-maker
Make YouTube Shorts that hold attention with Pexo — vertical 9:16, fast-paced, hook in the first 3 seconds. Describe your topic and Pexo writes the script, generates the shots, picks the models, and assembles a finished Short with music and captions. Use for YouTube Shorts: "youtube short", "make a youtube short", "shorts video", "short-form video". NOT for long-form or landscape video.
xcode-project-setup
Safely modifies Xcode projects (.pbxproj) to add Swift Packages and link files. Use this skill whenever an iOS project needs dependencies installed (e.g. Firebase, Alamofire).
x402
Set up Browser Use Cloud payments with x402 — pay per request from a crypto wallet (USDC on Base mainnet), no signup or API key. Two setups it works out up front — "just use it" (set up a wallet so you or Claude Code can run cloud browser tasks paid from the wallet — Claude writes and runs throwaway scripts, nothing touches your codebase) or "build it in" (install the SDK and write the key + code into your project). Walks through wallet setup, funding, .env, and a ~$1 test run. Use when the user asks about x402, pay-per-use, USDC payments, or wants Browser Use Cloud without an API key. For the free-tier signup (reverse-CAPTCHA → API key), use `browser-use cloud signup` or the `cloud` skill instead.
x-twitter-scraper
Build GitHub Copilot workflows with Xquik X API SDKs, REST endpoints, hosted Apify Actor runs, MCP tools, TweetClaw OpenClaw plugin installs, signed webhooks, tweet search, user lookup, follower exports, media actions, and agent automation.