design-md

Author, validate, and export Google DESIGN.md files with YAML front matter.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill automates the creation, validation, and exporting of Google's DESIGN.md files, streamlining the process of developing visual identities for coding agents.

Core Features & Use Cases

  • Authoring: Simplify the creation of DESIGN.md files by automatically writing YAML front matter.
  • Validation: Check for structure, token references, and WCAG compliance.
  • Exporting: Generate Tailwind theme JSON and W3C DTCG JSON for easy integration with other tools.
  • Use Case: A UI designer uses this Skill to quickly create a DESIGN.md file for a new brand identity, validate it for compliance, and export it to Tailwind for use in web development.

Quick Start

Run the 'design-md' skill with a new design file to generate the required front matter and create your DESIGN.md file.

Frequently Asked Questions about design-md

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

FAQPage Schema
What is a DESIGN.md file and when do I need one for my design system?

A DESIGN.md file defines visual identities for coding agents using YAML front matter and design tokens. You need one to structure branding guidelines and ensure WCAG compliance before exporting to development frameworks like Tailwind CSS.

How do I automate creating and validating a DESIGN.md file?

Automate DESIGN.md authoring and validation by running the design-md skill, which generates YAML front matter, lints structural compliance, checks token references, and verifies WCAG accessibility standards automatically.

Can I export DESIGN.md tokens to Tailwind CSS theme JSON?

Yes, you can export DESIGN.md tokens to Tailwind theme JSON and W3C DTCG JSON formats. This allows direct integration of your validated design tokens into Tailwind CSS web development workflows.

Do I need npm CLI to lint and export W3C DTCG JSON from DESIGN.md?

Yes, you need npm CLI installed to execute the design-md skill for file input and output operations. The skill relies on the npm environment to parse YAML, validate structure, and export W3C DTCG JSON.

What's the best way to manage version control for design system tokens in DESIGN.md?

Manage design system token versions by using the design-md skill to diff structural changes and lint YAML front matter. This ensures consistent token references and WCAG compliance across version updates before exporting.

Why does my DESIGN.md validation fail on token references and WCAG compliance?

DESIGN.md validation fails when YAML front matter contains broken token references or insufficient color contrast ratios. The linter checks structural integrity and WCAG compliance to prevent invalid tokens from exporting to Tailwind or W3C DTCG JSON.