design-md

Lint, diff, and transform design tokens into Tailwind or W3C DTCG formats.

2|1|Updated Jul 14, 2026
One-click install
npx skills add https://github.com/heysuhas/hermes_cli --skill design-md-heysuhas
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: design-md
Source: https://github.com/heysuhas/hermes_cli/tree/main/skills/creative/design-md
Command: npx skills add https://github.com/heysuhas/hermes_cli --skill design-md-heysuhas

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill solves the fragmentation of visual identity by providing a standardized, machine-readable format for design tokens that ensures consistency across codebases and design tools.

Core Features & Use Cases

  • Standardized Specification: Author visual identity specs using Google's DESIGN.md format, combining YAML tokens with Markdown rationale.
  • Automated Validation: Lint files for structure, broken references, and WCAG accessibility contrast compliance.
  • Multi-format Export: Convert design tokens into Tailwind theme JSON or W3C DTCG compliant formats for seamless integration into development workflows.

Quick Start

Ask the agent to lint the current DESIGN.md file in the project root to ensure all token references are valid and color contrast meets accessibility standards.

Frequently Asked Questions about design-md

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

FAQPage Schema
How do I validate design tokens for WCAG accessibility compliance?

Design tokens are standardized for UI components by authoring a DESIGN.md file that combines YAML tokens with Markdown rationale. This machine-readable format ensures consistent token application and solves visual identity fragmentation across codebases and design tools.

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

Yes, you can export design tokens to Tailwind theme JSON or W3C DTCG compliant formats. The skill transforms standardized DESIGN.md specifications into these formats for seamless integration into engineering development workflows.

How do I lint a DESIGN.md file to find broken token references?

You lint a DESIGN.md file by running structural validation against the project root to detect broken token references. This automated process ensures all visual identity token mappings are structurally sound and correctly linked.

Do I need a specific CLI tool to author and validate design token specs?

Yes, you need the @google/design.md CLI tool to author, validate, and transform design token specs. It performs the structural validation, linting, and WCAG accessibility checks required for the DESIGN.md format.

What is the best way to maintain visual identity consistency across UI components?

The best way to maintain visual identity consistency is using a standardized DESIGN.md specification to document tokens. This provides a single machine-readable source of truth that prevents fragmentation across codebases and design tools.