Design MD Skill ยท Documentation

Automate Your Semantic Design System with Stitch DESIGN.md

Generate semantic design systems for Stitch projects.

Analyze 2+ retrieval steps to create a DESIGN.md source of truth. Improve UI consistency today.

  • Stitch MCP
  • Design Systems
  • Semantic UI
  • Documentation Automation
  • Visual Descriptions

About This Skill

This skill automates the creation of DESIGN.md files for Stitch projects. By following 2 retrieval steps and 1 primary goal, it synthesizes technical assets into a semantic design system that serves as a source of truth for AI-driven UI generation.

Quick Start

  1. 1Install the Stitch MCP Server
  2. 2Run the design-md skill on your project
  3. 3Review the generated DESIGN.md file
Example Command
antigravity run design-md --project-id 'projects/12345'

Core Capabilities

Namespace Discovery

Automatically run list_tools to find and use the correct Stitch MCP prefix for all subsequent design analysis operations.

Project Lookup

Retrieve owned projects and extract Project IDs from metadata to identify target design assets for synthesis.

Semantic Design System Synthesis

Analyze technical assets to create a DESIGN.md file that acts as the source of truth for visual descriptions and color values.

Visual Description Generation

Generate specific color values and visual descriptions that Stitch interprets to align new screens perfectly with existing language.

Usage Examples

Before

Inconsistent UI prompts and manual color picking across different screens.

After

Automated DESIGN.md file ensuring 100% visual consistency across all new AI-generated screens.

Input

Update DESIGN.md based on the latest screen metadata.

Output

DESIGN.md updated with 3 new semantic tokens for dark mode support and updated primary button padding.

Input

Synthesize design language for project ID projects/98765.

Output

Successfully retrieved assets and synthesized semantic design system into DESIGN.md.

SKILL.md

---
name: design-md
description: "Analyze Stitch projects and synthesize a semantic design system into DESIGN.md files"
risk: safe
source: "https://github.com/google-labs-code/stitch-skills/tree/main/skills/design-md"
date_added: "2026-02-27"
---

# Stitch DESIGN.md Skill

You are an expert Design Systems Lead. Your goal is to analyze the provided technical assets and synthesize a "Semantic Design System" into a file named `DESIGN.md`.

## When to Use This Skill

Use this skill when:
- Analyzing Stitch projects
- Creating DESIGN.md files
- Synthesizing semantic design systems
- Working with Stitch design language
- Generating design documentation for Stitch projects

## Overview

This skill helps you create `DESIGN.md` files that serve as the "source of truth" for prompting Stitch to generate new screens that align perfectly with existing design language. Stitch interprets design through "Visual Descriptions" supported by specific color values.

## Prerequisites

- Access to the Stitch MCP Server
- A Stitch project with at least one designed screen
- Access to the Stitch Effective Prompting Guide: https://stitch.withgoogle.com/docs/learn/prompting/

## The Goal

The `DESIGN.md` file will serve as the "source of truth" for prompting Stitch to generate new screens that align perfectly with the existing design language. Stitch interprets design through "Visual Descriptions" supported by specific color values.

## Retrieval and Networking

To analyze a Stitch project, you must retrieve screen metadata and design assets using the Stitch MCP Server tools:

1. **Namespace discovery**: Run `list_tools` to find the Stitch MCP prefix. Use this prefix (e.g., `mcp_stitch:`) for all subsequent calls.

2. **Project lookup** (if Project ID is not provided):
   - Call `[prefix]:list_projects` with `filter: "view=owned"` to retrieve all user projects
   - Identify the target project by title or URL pattern
   - Extract the Project ID from the `name` field (e.g., `projects/1353445408

Frequently Asked Questions

FAQ

Which tools is this skill compatible with?
This skill requires access to the Stitch MCP Server and works with any Stitch project containing at least one designed screen.
Who is the target audience for this skill?
It is designed for Software Developers and Design System Leads working within the Stitch ecosystem who need to automate UI documentation.
How does this differ from standard documentation tools?
Unlike static docs, this skill synthesizes 'Visual Descriptions' that Stitch specifically uses to generate new, aligned UI components.
Does it support multiple languages?
The skill generates documentation in English, specifically optimized for the Stitch design language and prompting engine.
What are the expected results after running this skill?
You will receive a comprehensive DESIGN.md file that serves as a semantic source of truth for all future UI generation prompts.

Discussion

Discussion

0 comments
U

Trigger Phrases

Use these phrases to activate this skill in your AI coding assistant:

Analyze Stitch projectCreate DESIGN.mdSynthesize design systemGenerate design documentationStitch project lookup