design-md

Validate DESIGN.md token files for type correctness and export readiness.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

DESIGN.md tokens describe design systems; this Skill helps authors create, validate, lint, diff, and export tokens from DESIGN.md files to ensure consistency across projects and tools.

Core Features & Use Cases

  • Author DESIGN.md files and formalize tokens for cross-project reuse.
  • Lint structure, token references, and compatibility with WCAG checks.
  • Export tokens to formats such as Tailwind theme JSON and W3C Design Tokens JSON (DTCG).

Quick Start

Place a DESIGN.md in your project root and run the lint-export workflow to validate and export 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 in a DESIGN.md file for cross-project consistency?

To validate design tokens in a DESIGN.md file, you can use a linting workflow that checks token presence and type correctness. This ensures your design system remains consistent and export-ready across multiple project repositories.

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

Yes, you can export design tokens from DESIGN.md directly to Tailwind theme JSON. The export process transforms your validated tokens into the required format, ensuring your Tailwind configuration stays synchronized with your core design system.

What is the best way to lint DESIGN.md token references and check WCAG compatibility?

The best way to lint DESIGN.md token references and check WCAG compatibility is to run an automated validation workflow. This process evaluates structural integrity and token references to ensure your design tokens meet accessibility standards before export.

Does the DESIGN.md token format support exporting to W3C DTCG JSON?

Yes, the DESIGN.md token format fully supports exporting to W3C Design Tokens JSON (DTCG). This allows teams to standardize design tokens and share them across different tools and platforms that implement the W3C DTCG specification.

How do I set up a DESIGN.md file to start formalizing design tokens for reuse?

To set up a DESIGN.md file for formalizing design tokens, place the file in your project root. You can then define your tokens within the file and run the validation workflow to ensure they are structured correctly for cross-project reuse.

Why does my design token export fail validation when diffing across multiple repositories?

Design token export validation may fail during repository diffing due to missing tokens or incorrect types. The linting process enforces token presence and type correctness, ensuring all tokens are structurally valid and ready for export to formats like Tailwind.