Design Md

Create, update, validate, diff, or export DESIGN.md files following the Google Stitch DESIGN.md spec and @google/design.md tooling. Use when the user asks to write/update DESIGN.md, create a design system document, generate design tokens, encode brand/UI guidelines, export a design system, or document UI consistency rules for AI agents. Do NOT use for ordinary UI implementation unless the user asks for DESIGN.md or design-system documentation.

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add bolasblack/claude-skills --skill design-md
Manual install
git clone --depth 1 https://github.com/bolasblack/claude-skills.git /tmp/claude-skills
mkdir -p ~/.claude/skills
cp -r /tmp/claude-skills/skills/design-md ~/.claude/skills/design-md

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# DESIGN.md

Create or update a project-root `DESIGN.md` using the DESIGN.md format: preferably YAML front matter for machine-readable design tokens, followed by markdown sections for human-readable design rationale.

## Source of Truth

Read `references/format.md` first. It is the reference index and tells you which detailed files to load for the task.

Use two upstream sources:

1. `google-labs-code/design.md` is authoritative for spec, CLI, linter, export formats, and what `@google/design.md` accepts.
2. Stitch docs explain product/UI behavior and examples. When opening Stitch documentation pages, the actual documentation content may be nested inside two iframe layers; inspect the page's nested iframe tree and open the innermost documentation frame if normal page text is empty.

If these sources conflict, prefer `google-labs-code/design.md` for validation/tooling behavior and Stitch docs for Stitch UI behavior. When creating new files, generate YAML front matter by default; when validating existing files, accept prose-only files if the official tooling accepts them, but recommend adding front matter for precise agent/tool control.

Detailed references:
- `references/overview.md` for the DESIGN.md concept, creation paths, and minimal example.
- `references/specification.md` for YAML front matter, token schema, token references, canonical section order, aliases, and unknown-content behavior.
Read the full skill on GitHub

Details

Skill name
design-md
Path
skills/design-md/SKILL.md
Repo updated
18 November 2026

FAQ

What does the Design Md skill do?

Create, update, validate, diff, or export DESIGN.md files following the Google Stitch DESIGN.md spec and @google/design.md tooling. Use when the user asks to write/update DESIGN.md, create a design system document, generate design tokens, encode brand/UI guidelines, export a design system, or document UI consistency rules for AI agents. Do NOT use for ordinary UI implementation unless the user asks for DESIGN.md or design-system documentation.

How do I install the Design Md skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add bolasblack/claude-skills --skill design-md. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Design Md popular?

It lives in bolasblack/claude-skills, which has 5 GitHub stars and 0 forks.

Related skills

Caveman

5

bolasblack/claude-skills

Terse caveman voice: answer first, fluff gone, every technical fact kept. Use for /caveman, "caveman mode", "talk like caveman", "be brief", "less tokens". Stays on until "stop caveman" or "normal mode".

Images, Video & Audio

Agent Centric

5

bolasblack/claude-skills

Track decisions (AGD) with validation and indexing. Use when making design decisions, recording important choices, discussing trade-offs, or when user mentions AGD or decision record.

AI, LLMs & Agents

Codex

5

bolasblack/claude-skills

OpenAI Codex second opinion via the codex CLI — three modes. Review: independent diff review with a pass/fail gate. Challenge: adversarial pass that tries to break the code. Consult: ask Codex anything, with session continuity for follow-ups. Use when the user says "codex review", "codex challenge", "ask codex", or wants a second opinion from Codex.

Software Development

Design Taste Frontend

5

catch-the-wave/fullstack-ios-claude-skills

Senior UI/UX Engineer. Architect digital interfaces overriding default LLM biases. Enforces metric-based rules, strict component architecture, CSS hardware acceleration, and balanced design engineering.

Frontend & Design

Brand Guidelines

8

Freddy-CHEN-ux/00_claude_skills

Establish or analyze brand identity guidelines. Creates comprehensive brand documentation that frontend-design, testing, and other skills automatically reference for consistent execution.

Frontend & Design

Frontend Design

8

Freddy-CHEN-ux/00_claude_skills

Create distinctive, production-grade frontend interfaces with high design quality. Use when building web components, pages, or applications. Generates creative, polished code that avoids generic AI aesthetics.

Frontend & Design

Browse the most popular Claude skills, all frontend & design skills, or write your own with the skills generator.