design-md

Validate DESIGN.md token specs and export to Tailwind or W3C DTCG JSON.

1|Updated Jan 31, 2026
One-click install
npx skills add https://github.com/Monjyu1101/AiDiy2026 --skill design-md-monjyu1101
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: design-md
Source: https://github.com/Monjyu1101/AiDiy2026/tree/main/backend_hermes/skills/creative/design-md
Command: npx skills add https://github.com/Monjyu1101/AiDiy2026 --skill design-md-monjyu1101

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

DESIGN.md token specs are often created without validation, consistent structure, or easy export. This skill provides tooling to author, validate, and export DESIGN.md tokens to ensure consistency and interoperability across tools.

Core Features & Use Cases

  • Validate DESIGN.md files for correct frontmatter, token references, and WCAG contrast.
  • Lint, diff versions, and export tokens to Tailwind theme JSON or W3C DTCG JSON.
  • Use cases include maintaining design tokens for design systems, porting tokens between projects, and ensuring accessibility standards.

Quick Start

Place DESIGN.md at the project root and run the CLI to lint, diff, or export design tokens.

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 and ensure WCAG contrast in a markdown file?

You can validate design tokens by placing a DESIGN.md file at your project root and running the CLI to lint structure, verify frontmatter, check token references, and enforce WCAG contrast considerations for accessibility compliance.

Can I export design tokens to Tailwind theme JSON?

Yes, you can export design tokens to Tailwind theme JSON or W3C DTCG JSON formats. This enables cross-tool compatibility, allowing you to port validated tokens between projects and integrate them into your development workflows.

What is the best way to diff design token versions across updates?

The best way to diff design token versions is using the CLI's diff functionality on your DESIGN.md file. This compares token spec versions to track structural changes and maintain consistency across your design system updates.

Do I need frontmatter in my DESIGN.md token specs?

Yes, frontmatter is required in DESIGN.md token specs. The skill enforces frontmatter presence during validation to ensure tokens are well-formed and machine-readable for reliable export to Tailwind theme JSON or W3C DTCG JSON.

Does this tool work with W3C DTCG JSON format for design systems?

Yes, this tool works with W3C DTCG JSON format. It exports validated DESIGN.md token specs to W3C DTCG JSON, ensuring interoperability and cross-tool compatibility when porting tokens between different design system projects.