design-md

Lint, diff, and export DESIGN.md token specs with WCAG validation.

Updated Apr 9, 2026
One-click install
npx skills add https://github.com/nadicodeai/argo-agent --skill design-md-nadicodeai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: design-md
Source: https://github.com/nadicodeai/argo-agent/tree/main/skills/creative/design-md
Command: npx skills add https://github.com/nadicodeai/argo-agent --skill design-md-nadicodeai

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

DESIGN.md provides a structured, machine-readable design token spec that combines YAML front matter with human-readable rationale, enabling linting, diffing, and exporting of design tokens for reproducible UI systems and accessibility compliance.

Core Features & Use Cases

  • Lint DESIGN.md to validate token structure, references, and WCAG contrast rules.
  • Diff two DESIGN.md versions to detect regressions in tokens and typography.
  • Export tokens to Tailwind theme JSON or W3C Design Tokens JSON (DTCG) for downstream tooling.
  • Manage design tokens in a single source of truth to ensure consistent UI and branding across projects.

Quick Start

Run the CLI to lint a DESIGN.md file and export tokens to your desired format.

Frequently Asked Questions about design-md

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

FAQPage Schema
How do I validate WCAG contrast rules for design tokens in a markdown file?

Linting a DESIGN.md file validates WCAG contrast rules by checking the token structure, references, and color contrasts. This ensures your markdown-based design tokens meet accessibility compliance before exporting them to downstream UI systems.

What is the best way to diff two versions of design tokens to detect regressions?

The best way to diff design token versions is using the DESIGN.md diffing process to compare two file versions. This detects regressions in tokens and typography, ensuring consistent UI branding and preventing unintended visual changes across project updates.

Can I export markdown design tokens to Tailwind theme JSON or W3C DTCG format?

Yes, you can export markdown design tokens to Tailwind theme JSON or W3C Design Tokens JSON (DTCG) format. This enables downstream tooling integration by converting the YAML front matter and structured token specs into compatible configuration outputs.

Do I need the @google/design.md CLI to lint and export DESIGN.md token specs?

Yes, linting and exporting DESIGN.md token specs requires the @google/design.md CLI. This dependency provides the necessary tooling to validate token structures, apply WCAG rules, manage version diffs, and generate format exports for your project.

How do I manage design tokens as a single source of truth across multiple projects?

You manage design tokens as a single source of truth by maintaining a DESIGN.md file that combines YAML front matter with human-readable rationale. Linting and exporting these specs ensures consistent UI, typography, and branding across all connected projects.

What types of design tokens and component references does the DESIGN.md spec support?

The DESIGN.md spec supports tokens for colors, typography, and component references. Linting validates these structured elements against the specification, ensuring the machine-readable token definitions maintain reproducible UI systems and accessibility compliance.