design-md

Validate DESIGN.md files for token references and WCAG contrast.

Updated Aug 23, 2026

Search Tags:#wcag #diff #lint #design-system #export #design-token #design-md

Ready to run

npx skills add https://github.com/kotakbiasa/hermes-agent --skill design-md-kotakbiasa

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: design-md
Source: https://github.com/kotakbiasa/hermes-agent/tree/main/skills/creative/design-md
Command: npx skills add https://github.com/kotakbiasa/hermes-agent --skill design-md-kotakbiasa

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

DESIGN.md helps teams codify visual identity into machine-readable tokens and rationale, enabling consistent design systems across projects.

Core Features & Use Cases

Linting and validation of DESIGN.md structure, token references, and WCAG contrast to prevent regressions.
Diffing and exporting to Tailwind theme JSON and W3C Design Tokens JSON (DTCG) for interoperable tooling.
Porting and auditing design systems across projects, with guidance for designers and developers.

Quick Start

Create DESIGN.md in your project root and run the lint command to validate structure and token references.

Frequently Asked Questions about design-md

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

FAQPage Schema

How do I lint design tokens and check WCAG contrast in a markdown file?▼

To lint design tokens and check WCAG contrast, you validate DESIGN.md files by parsing YAML front matter, resolving token references, and running automated contrast checks to prevent accessibility regressions across your design system.

What is the best way to export design tokens to Tailwind theme JSON?▼

Exporting design tokens to Tailwind theme JSON requires a CLI tool that parses markdown design documentation and converts defined tokens into an interoperable Tailwind theme configuration file for development workflows.

Can I diff design tokens across multiple projects during a design system migration?▼

Yes, you can diff design tokens across multiple projects during a migration by auditing DESIGN.md files, which allows you to compare token definitions and rationale to ensure consistency across different repositories.

Does design token linting support exporting to the W3C Design Tokens JSON format?▼

Yes, design token linting supports exporting to the W3C Design Tokens JSON (DTCG) format, enabling interoperability with other design tools by converting markdown-defined tokens into the standardized W3C specification.

Why do I need YAML front matter parsing for design system documentation?▼

You need YAML front matter parsing for design system documentation because it structures machine-readable token metadata within DESIGN.md files, enabling automated validation, reference checking, and consistent token exports across projects.