agentleFS
Sign inStart free
PracticalSwanPracticalSwan/agent-skills/stitch-design/SKILL.md

stitch-design

Skill22 starsChanged 25 days agoMITView on GitHub

Route Google Stitch tasks to the correct imported Stitch skill, with verified MCP tool boundaries, upload safety, and cross-client fallback guidance.

12 other projects use a version of this.

Adopted by

Most recently taken up by

The file

We split this skill into the rules it gives an agent

9 rules. 0 are common, 5 are distinctive, and 4 are very specific to this project.

  • 0

    Common

    Most of the 12 edited versions we read keep these.

  • 5

    Distinctive

    This author's own choices. Worth a look.

  • 4

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Very specific:

    Use this as the entrypoint for Google Stitch work.

    line 11
  2. Distinctive:

    Check the available Stitch MCP tools before naming or calling a tool.

    line 51
  3. Very specific:

    Keep .stitch/DESIGN.md, .stitch/metadata.json, screenshots, and static HTML as the local evidence trail when the workflow creates them.

    line 52
  4. Distinctive:

    Ask before external uploads unless the current user request already approves that exact upload target and artifact.

    line 53
  5. Very specific:

    Verify with Stitch MCP when the requested operation matches the available tool surface.

    line 54
  6. Very specific:

    Use local .stitch/ artifacts, exported HTML or screenshots, bundled scripts, and the Stitch web UI when the host does not expose the needed …

    line 76
  7. Distinctive:

    Do not claim screen lookup, generation, editing, or variant MCP calls unless those tools are present in the active host tool list.

    line 77
  8. Distinctive:

    Do not claim an MCP operation was used when the active host does not expose it.

    line 78
  9. Distinctive:

    Before claiming Stitch work is complete:

    line 91

“Common” is measured: kept by at least 6 in 10 of the 12 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Stitch Design

Use this as the entrypoint for Google Stitch work. The old local monolithic Stitch guidance has been consolidated into narrower skills imported from https://github.com/google-labs-code/stitch-skills at commit 7b53207b94e62911777d53d4238b5f8c88c2b519. This file now routes tasks and carries shared safety rules; detailed workflows live in the dedicated stitch-* skills.

When to Use This Skill

  • The user asks for Stitch, Google Stitch, Stitch MCP, DESIGN.md, Stitch screen generation, Stitch upload, or Stitch-to-code work.
  • The task is unclear and needs routing to the correct Stitch design, build, or utility workflow.
  • A previous broad Stitch workflow would have mixed upload, prompt, design-system, code, and video steps in one place.

Route Selection

SkillUse when
stitch-code-to-designConvert an existing frontend into Stitch-ready design assets by extracting static HTML, writing DESIGN.md, creating the design system, and uploading approved files.
stitch-generate-designPrepare Stitch screen-generation, edit, image-to-design, and variant prompts with verified tool checks and design-system-aware wording.
stitch-manage-design-systemCreate, list, and apply Stitch design systems from DESIGN.md using the verified Stitch MCP design-system tools and safe upload fallbacks.
stitch-extract-design-mdExtract a Stitch-compatible DESIGN.md from frontend source code, stylesheets, Tailwind config, theme files, and component patterns.
stitch-extract-static-htmlCapture a self-contained static HTML snapshot from a running app or mock component so it can be reviewed or uploaded to Stitch.
stitch-upload-to-stitchUpload approved local HTML, markdown, or image assets to a Stitch project using direct MCP for small DESIGN.md files or the bundled API script for larger files.
stitch-react-componentsConvert Stitch HTML and screenshots into modular Vite/React/TypeScript components, or sync existing components to updated Stitch designs, with local architecture and validation checks.
stitch-react-vite-dashboardConvert approved Stitch exports into accessible React and Vite dashboards with DESIGN.md tokens, TanStack Query data boundaries, responsive layouts, and optional read-only Web3 integrations.
stitch-react-nativeConvert Stitch HTML designs into React Native screens, or sync existing native components to updated Stitch designs, using native primitives, StyleSheet rules, and mobile platform checks.
stitch-remotionCreate Remotion walkthrough videos from Stitch screen exports with ordered assets, transitions, captions, and render checks.
stitch-shadcn-uiIntegrate Stitch-derived UI direction into shadcn/ui React projects with registry-aware setup, ownership rules, theming, and validation.
stitch-design-mdAnalyze existing Stitch project evidence and synthesize a semantic DESIGN.md for consistent future Stitch generation.
stitch-enhance-promptTransform rough UI requests into structured Stitch prompts with platform, layout, component, and design-system context.
stitch-loopRun an iterative Stitch website-building loop using .stitch/next-prompt.md, SITE.md, DESIGN.md, generated pages, and verification checkpoints.
stitch-taste-designCreate opinionated premium DESIGN.md guidance for Stitch, emphasizing calibrated typography, restrained color, layout discipline, motion, and anti-generic UI rules.

Consolidation Decision

The previous stitch-design skill repeated design-md, React conversion, build-loop, prompt-enhancement, Remotion, and shadcn/ui guidance in one large file. Those important parts were not removed; they were moved into dedicated skills with clearer triggers, support assets, and verification protocols. This entrypoint stays small so agents choose the narrowest Stitch workflow first.

Verified Stitch MCP Surface

Verified in this workspace on 2026-06-15: create_project, upload_design_md, create_design_system_from_design_md, list_design_systems, and apply_design_system. This 2026-07-29 source refresh did not re-verify a broader live MCP surface. Treat screen lookup, screen generation, screen editing, and variant generation tools as optional host-specific capabilities. Use them only when they are present in the active tool list.

Common Workflow

  1. Classify the task as prompt work, design-system work, static extraction, upload, screen generation, code generation, video generation, or iterative site building.
  2. Open and follow the narrowest related Stitch skill.
  3. Check the available Stitch MCP tools before naming or calling a tool.
  4. Keep .stitch/DESIGN.md, .stitch/metadata.json, screenshots, and static HTML as the local evidence trail when the workflow creates them.
  5. Ask before external uploads unless the current user request already approves that exact upload target and artifact.
  6. Verify with Stitch MCP when the requested operation matches the available tool surface; otherwise document the web UI/API/local fallback used.
<!-- MCP:START --><!-- PORTABILITY:START -->

Cross-Client Portability

This skill is written to stay usable across GitHub Copilot, Claude Code, and Codex.

  • GitHub Copilot: keep the folder in a Copilot-visible skill path or wrap the workflow in project instructions when folder discovery is unavailable.
  • Claude Code: keep the folder in a local skills directory or a compatible plugin source.
  • Codex: install or sync the folder into $CODEX_HOME/skills/stitch-design and restart Codex after major changes.
<!-- PORTABILITY:END -->

MCP Availability And Fallback

Preferred MCP Server: Stitch MCP

  • Fallback prompt: "Use the Stitch Design skill without MCP. Follow the documented local or manual fallback, show the selected tool surface, and report the verification evidence."
  • Use local .stitch/ artifacts, exported HTML or screenshots, bundled scripts, and the Stitch web UI when the host does not expose the needed Stitch MCP operation.
  • Do not claim screen lookup, generation, editing, or variant MCP calls unless those tools are present in the active host tool list.
  • Do not claim an MCP operation was used when the active host does not expose it.
<!-- MCP:END -->

Anti-Patterns

  • Using this entrypoint as a replacement for reading the dedicated skill that matches the task.
  • Claiming unavailable Stitch MCP screen tools exist because an upstream skill mentioned them.
  • Uploading assets or creating external Stitch state without a clear project target and approval.
  • Combining Stitch-specific skills into generic frontend skills when Stitch project IDs, DESIGN.md, or MCP evidence matter.

Verification Protocol

Before claiming Stitch work is complete:

  1. Pass/fail: The correct dedicated Stitch skill was selected and followed.
  2. Pass/fail: The active Stitch MCP tool surface was checked and any unavailable tools were handled honestly.
  3. Pass/fail: Local artifacts or external Stitch IDs were recorded with enough detail to reproduce the result.
  4. Pass/fail: Uploads and external state changes had user-approved artifact and destination details.
  5. Pressure-test scenario: Re-run the route selection with only the verified design-system MCP tools available and confirm the fallback path still works.
  6. Success metric: The final response names the selected Stitch skill, evidence used, and whether verification was local, MCP-backed, or manual.

Related Skills

  • stitch-code-to-design: Dedicated Stitch workflow.
  • stitch-generate-design: Dedicated Stitch workflow.
  • stitch-manage-design-system: Dedicated Stitch workflow.
  • stitch-extract-design-md: Dedicated Stitch workflow.
  • stitch-extract-static-html: Dedicated Stitch workflow.
  • stitch-upload-to-stitch: Dedicated Stitch workflow.
  • stitch-react-components: Dedicated Stitch workflow.
  • stitch-react-vite-dashboard: Dedicated Stitch workflow.
  • stitch-react-native: Dedicated Stitch workflow.
  • stitch-remotion: Dedicated Stitch workflow.
  • frontend-design: Use when the task needs general UI composition beyond Stitch.

Download now (ZIP)

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
What did you use it for? e.g. Reviewing pull requests in a Rails app

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.

Check your setup, free