design-md

Generate a Stitch-compliant DESIGN.md from design tokens and component APIs.

Updated Mar 27, 2026
One-click install
npx skills add https://github.com/moonklabs/skills --skill design-md-moonklabs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: design-md
Source: https://github.com/moonklabs/skills/tree/main/design-system/skills/design-md
Command: npx skills add https://github.com/moonklabs/skills --skill design-md-moonklabs

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Generate a Stitch-format DESIGN.md from a project's design tokens, components, and branding references, providing a single source of truth for design documentation across teams.

Core Features & Use Cases

  • Automatic discovery and extraction of tokens, typography, colors, spacing, and component APIs
  • Generates DESIGN.md with YAML frontmatter and an eight-section markdown body
  • Supports linting, export, and updates via the design.md tooling

Quick Start

Invoke the design-md skill against your design-system repository to generate DESIGN.md per the Stitch alpha spec.

Frequently Asked Questions about design-md

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate a DESIGN.md file from design tokens?

To generate a DESIGN.md file from design tokens, you can automatically extract colors, typography, spacing, and component APIs to produce YAML frontmatter and an eight-section Markdown body.

What is a Stitch-format design system documentation file?

A Stitch-format design system documentation file is a single source of truth that uses YAML frontmatter and an eight-section Markdown body to standardize design tokens and component APIs for sharing.

How do I extract design tokens and component APIs into Markdown documentation?

You can extract design tokens and component APIs into Markdown documentation by analyzing token sources and component structures to automatically generate an export-ready, lint-compliant DESIGN.md file.

Can I validate design token references when generating Markdown documentation?

Yes, you can validate design token references during Markdown documentation generation, ensuring that all extracted colors, typography, and spacing values are accurate before producing the final output.

What's the best way to document a design system for cross-team sharing?

The best way to document a design system for cross-team sharing is to generate a standardized DESIGN.md file that consolidates tokens, component APIs, and branding references into a single source of truth.

Do I need existing component APIs to create a Stitch-compliant DESIGN.md?

Yes, existing component APIs and token sources like colors, typography, and spacing are analyzed to automatically discover and extract the data needed to create a Stitch-compliant DESIGN.md.