# Create DESIGN.md Guides from Stitch Projects

Design teams need a clear source of truth for consistent AI-generated screens. This skill turns Stitch screens, metadata, and visual assets into a structured DESIGN.md guide.

## Install

```bash
npx skillstore add google-labs-code/design-md
```

## Metadata

- Status: approved
- Slug: google-labs-code-design-md
- Skillstore revision: r1
- Version status: missing
- Tree hash: 3b4852beaa7248b02f3554cac2d99dd5decad7f446ddc7c200bffb0d91c234f0
- Author: google-labs-code
- GitHub username: google-labs-code
- License: MIT
- Repository: https://github.com/google-labs-code/stitch-skills/tree/main/skills/design-md/
- Ref: 1ffa7643651792ccb4bd3b15d924d2c97edff755
- Supported tools: Claude, Codex, Claude Code
- Audit status: complete
- Agent install advisory: allowed
- Manual install advisory: allowed
- Artifact signature: available
- Audit attestation: unavailable
- Human verification: not\_verified
- Risk factors: external\_commands, network
- Quality score: 69
- Public page: https://skillstore.pages.dev/skills/google-labs-code-design-md
- Manifest: https://skillstore.pages.dev/api/skills/google-labs-code-design-md/manifest

## Capabilities

- Discovers Stitch MCP projects and screens when identifiers are missing.
- Retrieves Stitch screen metadata, HTML, screenshots, and project design theme data.
- Extracts colors, typography, layout rules, component styles, and visual atmosphere.
- Translates technical Tailwind and CSS values into plain design language.
- Writes a structured DESIGN.md file for future Stitch prompting.

## Use Cases

- Document a product design language: Create a reusable DESIGN.md from an existing Stitch screen so future screens keep the same style.
- Standardize AI screen generation: Give Claude, Codex, or Claude Code a precise design reference before asking for new UI screens.
- Capture handoff guidance: Summarize colors, typography, spacing, and component behavior for teams that need shared design context.

## Prompt Templates

### Create a basic DESIGN.md

```
Use design-md to analyze my Stitch project and create a DESIGN.md file for the main screen.
```

### Analyze a specific screen

```
Use design-md on project [project ID] and screen [screen ID]. Focus on colors, typography, components, and layout rules.
```

### Build a reusable style guide

```
Analyze the selected Stitch screen and write a DESIGN.md that future prompts can use to create matching pages.
```

### Produce a detailed design-system reference

```
Use design-md to retrieve the Stitch screen HTML, screenshot, and project theme. Create a detailed DESIGN.md with atmosphere, tokens, components, layout, and prompt guidance.
```

## Limitations

- Requires access to the Stitch MCP server and a project with at least one screen.
- Output quality depends on the available screen, HTML, screenshot, and project metadata.
- It documents design guidance but does not validate accessibility or production code quality.
- It may need user confirmation before inspecting private project assets.

## Best Practices

- Provide the exact Stitch project and screen when possible to avoid broad project discovery.
- Review the generated DESIGN.md for brand accuracy before using it as a prompt source.
- Use one strong reference screen before expanding the guide with additional screens.

## Anti Patterns

- Do not ask it to inspect all projects when only one project is relevant.
- Do not treat the generated guide as a complete accessibility audit.
- Do not use vague prompts when exact project and screen identifiers are available.

## Security Audit

- Audited at: 2026-07-09T04:28:22.951\+00:00
- Summary: Static findings for shell execution, reconnaissance, hardcoded URLs, and screen capture upload are false positives caused by markdown examples, Stitch MCP tool references, design terminology, and a public documentation link. The main security concern is semantic: the skill can enumerate owned Stitch projects and retrieve private HTML and screenshots unless the user scopes the project explicitly.

## Stats

- Views: 201
- Downloads: 12
- Favorites: 0
- Popularity score: 0