stitch-design-md

stitch-design-md is a skill for Codex from PracticalSwan/agent-skills. It costs 23 tokens per session (1,236 once invoked), scanned A, original, MIT.

A guide for writing a DESIGN.md file from existing Stitch project evidence such as screens, screenshots, HTML, or design metadata. The file records the product’s visual and interaction rules.

In plain words
What is it for?
Use it to document colors, typography, spacing, components, responsive behavior, and interaction patterns from an existing Stitch project.
Why use it?
It turns scattered design evidence into one reference that can guide future screen generation.

Skill for Codex

Written for Codex: reads ~/.codex or $CODEX_HOME. Also seen: mentions Claude Code; mentions Codex.

Good fit Use it to document colors, typography, spacing, components, responsive behavior, and interaction patterns from an existing Stitch project.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/practicalswan/agent-skills/stitch-design-md
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add PracticalSwan/agent-skills --skill stitch-design-md
Clone the repo
git clone --depth 1 https://github.com/PracticalSwan/agent-skills

Made for: Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for stitch-design-md

README.md
[![agentmods](https://agentmods.dev/badge/skills/practicalswan/agent-skills/stitch-design-md/github.svg)](https://agentmods.dev/skills/practicalswan/agent-skills/stitch-design-md)
Your own site
<a href="https://agentmods.dev/skills/practicalswan/agent-skills/stitch-design-md"><img src="https://agentmods.dev/badge/skills/practicalswan/agent-skills/stitch-design-md/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for stitch-design-md

Your own site · 80×15
<a href="https://agentmods.dev/skills/practicalswan/agent-skills/stitch-design-md"><img src="https://agentmods.dev/badge/skills/practicalswan/agent-skills/stitch-design-md.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 23 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,236 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00023 $0.01236
Opus 5 $0.00012 $0.00618
Sonnet 5 $0.00005 $0.00247
Haiku 4.5 $0.00002 $0.00124

Measured 4d ago against content hash 6decb95e1dc4, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-12, from the pricing page.

Security

Grade A, and why

stitch-design-md scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 4d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

Origin

Copies of this mod

1 near-identical copy found in the catalogue:

stitch-design-md/SKILL.md · 88 lines

How it starts

The opening of the file, as written. The whole thing — 88 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Stitch DESIGN.md From Project

This skill is a catalog-normalized import from https://github.com/google-labs-code/stitch-skills at commit 7b53207b94e62911777d53d4238b5f8c88c2b519, source path plugins/stitch-utilities/skills/design-md. The upstream control file was corrected for this workspace: the verified Stitch MCP surface here is design-system oriented, so screen lookup, screen generation, and screen editing tools must be used only when the current host explicitly exposes them.

When to Use This Skill

  • Use when existing Stitch screens, screenshots, HTML, or metadata should become a DESIGN.md source of truth.
  • The task involves Google Stitch project IDs, .stitch/ artifacts, DESIGN.md files, Stitch exports, or Stitch-specific validation.
  • The broader stitch-design router points here as the narrowest workflow.

Workflow

  1. Gather screenshots, exported HTML, design-system metadata, user descriptions, or host-listed screen retrieval output.
  2. Do not assume this workspace exposes list_projects, list_screens, get_screen, or get_project.
  3. Extract atmosphere, palette, typography, shape, elevation, components, layout, responsive behavior, and interaction states.
  4. Translate CSS/Tailwind into descriptive names with exact values.
  5. Write .stitch/DESIGN.md with project title and reusable prompting language.
  6. Hand off to stitch-manage-design-system for upload.

Local Assets

  • examples/, resources/, references/, or reference/ are upstream support material when present. Treat SKILL.md as the source of truth if a support file mentions an unavailable MCP tool.
  • scripts/ are optional helpers. On Windows, prefer PowerShell or Node equivalents unless Git Bash or WSL is actually available.
  • Keep generated .stitch/ files out of commits unless the user explicitly wants them as durable examples.

Corrected 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. Do not claim list_projects, list_screens, get_project, get_screen, generate_screen_from_text, edit_screens, or generate_variants were used unless the current host exposes those exact tools in the active tool list.

Read the full file on GitHub · 88 lines

Files

What ships with it

3 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 4d ago Changed 6decb95e1dc4
  2. 6d ago Changed 624da6689af0
  3. 8d ago First seen · 88 lines · 23 tokens per session scan A 3602cadd9ca6

Subscribe to this mod's changes

stitch-design-md is a skill published in the GitHub repository PracticalSwan/agent-skills (14 stars, last pushed 4d ago), licensed MIT. It adds 23 tokens to every session and 1,236 once invoked, about $0.0001 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-09-03.

Related

Other skills, from other repositories

design-engineering

Premium design engineering skill for agentic workflows — produces high-end, distinctive UI designs using DESIGN.md as the portable contract across Pencil MCP (in-IDE canvas), Figma MCP (team handoff + design tokens), and Google Stitch (vibe exploration + AI generation). Enforces anti-generic principles, WCAG 2.2 AA…

broomva/skills · 231 tokens

design-md

Author/validate/export Google's DESIGN.md token spec files.

mateaix/mateclaw · 14 tokens

omd-apply

A skill that applies a project's DESIGN.md file as visual and brand guidance for interface work. It covers components, colors, fonts, layout, copy, motion, and visual assets.

kwakseongjae/oh-my-design · 129 tokens

use-design-md

Pull a Korean brand's published design.md from the ko-design-md catalog (getdesign.kr) and apply its design language — colors, typography, spacing, radius, components, do's & don'ts — to the UI you are building in the CURRENT project. Use this skill whenever the user wants to build or restyle UI in the style of a…

CaesiumY/ko-design-md · 226 tokens

penpot-mcp

Use this skill whenever the user wants to use AI agents to work with Penpot design files via the Penpot MCP Server. Triggers include: using Penpot through an AI agent, design files, design systems, design tokens, Penpot MCP, design-to-code, generating UI from design, auditing a design system, creating…

ar27111994/penpot-mcp · 175 tokens

brandmd

Extract a website's design system into a DESIGN.md file. Use when starting a new frontend project, rebuilding a site, or when the user wants AI-generated UI to match an existing brand.

yuvrajangadsingh/brandmd · 41 tokens