design-md

Lint, diff, and export DESIGN.md files to Tailwind or DTCG JSON.

Updated May 5, 2026
One-click install
npx skills add https://github.com/Z43L/zeus-agent --skill design-md-z43l
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: design-md
Source: https://github.com/Z43L/zeus-agent/tree/main/skills/creative/design-md
Command: npx skills add https://github.com/Z43L/zeus-agent --skill design-md-z43l

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you produce correct, consistent, and accessibility-aware DESIGN.md design-spec files that agents and toolchains can reliably consume.

Core Features & Use Cases

  • Structure, token, and rules validation: Ensures the file follows the required canonical section order and catches invalid tokens, broken references, and unknown component properties.
  • Version regression detection: Diffs two DESIGN.md files to fail on regressions in normative values and component definitions.
  • Export for integration: Converts DESIGN.md into Tailwind theme JSON or W3C DTCG JSON for downstream UI and design-token pipelines, plus a JSON “spec” view for prompt injection.
  • WCAG contrast checks: Evaluates component foreground/background color pairs against WCAG AA/AAA thresholds to prevent inaccessible UI states.

Quick Start

Ask the agent to lint, diff, and export your DESIGN.md into Tailwind JSON and DTCG 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 file for token and structure validation?▼

You can export DESIGN.md specs into Tailwind theme JSON for UI integration or W3C DTCG JSON for design-token pipelines, plus a JSON spec view for prompt injection.

Can I check WCAG color contrast issues in my design specs?▼

Yes, WCAG contrast checks evaluate component foreground and background color pairs against WCAG AA and AAA thresholds to prevent inaccessible UI states within your DESIGN.md file.

How do I export design tokens from DESIGN.md to Tailwind or DTCG JSON?▼

You can export DESIGN.md specs into Tailwind theme JSON for UI integration or W3C DTCG JSON for design-token pipelines, plus a JSON spec view for prompt injection.

What is the best way to diff two DESIGN.md files for version regressions?▼

Diffing two DESIGN.md files detects version regressions by failing on changes to normative values and component definitions, ensuring design spec consistency across updates.

Does design-md work without external dependencies?▼

Yes, the Skill operates with no listed dependencies, using the @google/design.md CLI to parse, lint, and export your design-spec files directly within your environment.