design-md

Create, validate, and export Google DESIGN.md files to Tailwind CSS or W3C DTCG JSON.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires python, yaml, tailwindcss, dtcg, and includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

This Skill automates the creation, validation, and export of Google's DESIGN.md token spec files, streamlining the process of defining and managing design systems.

Core Features & Use Cases

  • Authoring: Generate and maintain DESIGN.md files with machine-readable tokens and human-readable rationale.
  • Validation: Check for structural integrity, token references, and WCAG contrast compliance.
  • Export: Convert DESIGN.md files to Tailwind CSS or W3C DTCG JSON for use in various tools.
  • Use Case: If you need to create a design system spec for a project and want to ensure it is accessible and consistent, this Skill can help you do so efficiently.

Quick Start

Use the design-md skill to validate the structure and accessibility of your DESIGN.md file 'brand-spec.md'.

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 compliance in a DESIGN.md token spec?

You can validate WCAG contrast compliance in a DESIGN.md token spec by using an automated tool to check structural integrity, token references, and color accessibility. This ensures your design system maintains proper visual accessibility standards.

How do I export design tokens from a DESIGN.md file to Tailwind CSS?

To export design tokens to Tailwind CSS, use a conversion tool that parses the DESIGN.md file and transforms the machine-readable tokens into a Tailwind CSS configuration. This bridges your design system spec with frontend development.

Can I generate W3C DTCG JSON from a Google DESIGN.md file?

Yes, you can generate W3C DTCG JSON from a Google DESIGN.md file by exporting the validated token spec. This conversion allows your design system tokens to be consumed by tools supporting the W3C Design Tokens Community Group format.

Do I need Python to automate DESIGN.md token spec authoring and validation?

Yes, you need Python installed to automate DESIGN.md token spec authoring and validation, as the process requires Python for parsing the markdown files, running validation checks, and executing format conversions to Tailwind CSS or DTCG JSON.

What is the best way to maintain machine-readable and human-readable design system tokens?

The best way to maintain design system tokens is to use an automated authoring process that generates DESIGN.md files containing both machine-readable tokens and human-readable rationale. This ensures consistency and documentation across your design system.

Does design token validation check structural integrity and token references automatically?

Yes, design token validation automatically checks structural integrity and token references within the DESIGN.md file. This automated process ensures your design system spec is correctly formatted and that all token dependencies resolve properly.