design-md

Parse and validate Google DESIGN.md token spec files for structure and references.

11|Updated May 17, 2026
One-click install
npx skills add https://github.com/StarryCod/cogitum --skill design-md-starrycod
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: design-md
Source: https://github.com/StarryCod/cogitum/tree/main/cogitum/data/skills/creative/design-md
Command: npx skills add https://github.com/StarryCod/cogitum --skill design-md-starrycod

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

DESIGN.md is Google's open spec (Apache-2.0, google-labs-code/design.md) for describing a visual identity to coding agents. One file combines:

  • YAML front matter with machine-readable design tokens (normative values)
  • Markdown body with rationale and usage guidance

The CLI (npx @google/design.md) lint, diff, and export to Tailwind or DTCG JSON.

Core Features & Use Cases

  • Lint DESIGN.md to verify structure, token references, and WCAG contrast.
  • Diff versions to detect regressions and track changes over time.
  • Export tokens to Tailwind theme JSON or W3C DTCG JSON for integration with design tooling.
  • Port a brand style guide into machine-readable tokens for automation and consistency.

Quick Start

Install and run the DESIGN.md CLI on your DESIGN.md file to lint, then optionally diff and export tokens.

Frequently Asked Questions about design-md

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

FAQPage Schema
How do I lint a DESIGN.md token spec to verify structure and WCAG contrast?

You can lint a DESIGN.md token spec by running the CLI to verify YAML frontmatter structure, token references, and WCAG contrast compliance. This ensures your machine-readable design tokens and markdown rationale maintain a canonical schema.

How do I export design tokens to Tailwind theme JSON or W3C DTCG JSON?

Export design tokens to Tailwind theme JSON or W3C DTCG JSON by applying the export tool to your DESIGN.md file. This converts YAML frontmatter normative values into formats compatible with coding agents and design tooling.

What is the best way to diff DESIGN.md versions to detect token regressions?

Diff DESIGN.md versions to detect token regressions by comparing the YAML frontmatter normative values across file versions. This highlights structural changes and token reference updates to track visual identity shifts over time.

Can I use a DESIGN.md token spec to port a brand style guide for coding agents?

Yes, you can port a brand style guide into a DESIGN.md token spec to provide coding agents with machine-readable design tokens. This combines normative YAML values with markdown rationale to automate consistent UI implementation.

Does the DESIGN.md schema enforce a strict section order for token definitions?

Yes, the DESIGN.md schema enforces a canonical token schema in YAML frontmatter and a strict section order in the markdown body. This structure is required for the lint, diff, and export processes to validate token references correctly.