design-md

Author, validate, and export DESIGN.md token specs to Tailwind and DTCG JSON.

13|3|Updated May 12, 2026
One-click install
npx skills add https://github.com/kevinnft/ai-agent-skills --skill design-md-kevinnft
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: design-md
Source: https://github.com/kevinnft/ai-agent-skills/tree/main/skills/creative/design-md
Command: npx skills add https://github.com/kevinnft/ai-agent-skills --skill design-md-kevinnft

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

DESIGN.md is Google's open spec for design tokens and system guidelines. This skill helps authors create, validate, and export DESIGN.md token specs to ensure consistency and interoperability across tools and teams.

Core Features & Use Cases

  • Author DESIGN.md token specs with a machine-readable front matter for strict validation.
  • Validate token definitions, lint structure, and export artifacts (Tailwind, DTCG) for design systems.
  • Use Case: Port a design system into tooling pipelines to maintain consistency across projects.

Quick Start

Create or update DESIGN.md in your project root and run the DESIGN.md CLI to lint and export.

Frequently Asked Questions about design-md

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

FAQPage Schema
What is the DESIGN.md format for design tokens?

DESIGN.md is Google's open specification for design tokens and system guidelines. It uses machine-readable front matter with a required name and description to enable strict validation and maintain consistency across design tooling pipelines.

How do I export design tokens to Tailwind and DTCG JSON?

You can export design tokens to Tailwind and DTCG JSON by authoring a DESIGN.md file in your project root and running the DESIGN.md CLI to lint the token structure and generate the specified export artifacts.

Does the DESIGN.md spec support token references?

Yes, the DESIGN.md spec supports token references. The validation tooling enforces the front matter schema and checks token references to ensure your design system definitions remain structurally correct and portable.

What is the best way to validate a DESIGN.md file structure?

The best way to validate a DESIGN.md file is to run the Google Labs design.md CLI tool. It lints token definitions, enforces the required front matter schema, and checks token references to prevent structural errors.

Why does my DESIGN.md validation fail during linting?

DESIGN.md validation fails during linting if your file lacks the required front matter schema. The spec strictly enforces that your document must include both a name and description to pass structural validation checks.