design-md

Author, validate, and export DESIGN.md design token files to Tailwind or W3C DTCG JSON.

1|Updated Jun 25, 2026
One-click install
npx skills add https://github.com/Signmanal/VIGIL --skill design-md-signmanal
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: design-md
Source: https://github.com/Signmanal/VIGIL/tree/main/skills/creative/design-md
Command: npx skills add https://github.com/Signmanal/VIGIL --skill design-md-signmanal

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill eliminates the friction of creating consistent, accessible, machine-readable design system specifications that sync across tools and projects, removing manual token management and WCAG compliance guesswork.

Core Features & Use Cases

  • DESIGN.md Authoring: Generate fully structured, spec-compliant DESIGN.md files with valid YAML frontmatter for design tokens, aligned with Google's open standard.
  • Validation & Linting: Run automated checks for broken token references, duplicate sections, invalid token values, and WCAG contrast ratios to ensure specs are error-free and accessible.
  • Export & Integration: Export validated specs to Tailwind theme JSON or W3C DTCG format for seamless use in frontend projects. For example, if you are building a multi-product design system, use this Skill to create a single source of truth for tokens that can be linted for accessibility and exported to all your team's frontend tools.

Quick Start

Use the design-md skill to create a validated DESIGN.md file for my brand's design system with a primary color of #1A1C1E and Inter as the base typeface.

Frequently Asked Questions about design-md

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

FAQPage Schema
How do I create a machine-readable design token specification for my design system?

To create a machine-readable design token specification, you can author a structured DESIGN.md file with valid YAML frontmatter. This generates a single source of truth for your brand's visual identity, ensuring tokens are structured and consistent.

How do I validate WCAG contrast ratios for my design tokens?

You can validate WCAG contrast ratios by running automated linting checks on your design token specifications. This process detects invalid token values and ensures your UI color combinations meet accessibility compliance standards before frontend integration.

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

Yes, you can export validated design token specifications directly to Tailwind theme JSON or W3C DTCG format. This conversion provides machine-readable output for seamless integration into your frontend development workflow.

What is the best way to manage design tokens across multiple frontend tools?

The best way to manage design tokens across multiple tools is maintaining a single DESIGN.md file as your source of truth. You can then lint it for accessibility and export the validated tokens to various formats for your team's frontend projects.

Why does my design system have broken token references and duplicate sections?

Broken token references and duplicate sections occur when design token specs are managed manually without linting. Running automated validation checks identifies these structural errors, ensuring your design system specifications remain error-free.

Do I need a specific framework to author DESIGN.md files?

No specific framework is required to author DESIGN.md files. You can generate a spec-compliant file with valid YAML frontmatter by providing your brand's design tokens, such as a primary color hex code and base typeface.