design-md

Create and validate DESIGN.md specs with YAML tokens and WCAG checks.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps you define, validate, and export a formal DESIGN.md file so teams and coding agents can share one source of truth for brand and UI decisions.

Core Features & Use Cases

  • Authoring a design spec: Create a structured DESIGN.md with frontmatter tokens and canonical narrative sections.
  • Validation and accessibility checks: Lint token references, section order, value formats, and WCAG contrast issues before shipping.
  • Export and migration: Convert the same design system into Tailwind theme JSON or W3C DTCG token JSON for downstream use.
  • Use case: A product team can turn an existing style guide into an agent-readable spec, then export matching tokens for implementation in a web app.

Quick Start

Use the design-md skill to turn this brand brief into a valid DESIGN.md file and include accessibility-safe tokens.

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 DESIGN.md spec for my design tokens?

To create a DESIGN.md spec, provide a brand brief or style guide. The system generates a structured specification with YAML front matter, canonical narrative sections, and validated token references for your design system.

What's the best way to check WCAG contrast issues in my design system tokens?

Run your design tokens through the validation process to check WCAG contrast issues. It lints token references, section order, and value formats while performing WCAG contrast checks to ensure accessibility compliance.

Can I export my design system tokens to Tailwind theme JSON?

Yes, you can export your design system tokens to Tailwind theme JSON. The validated DESIGN.md specification can be converted into matching tokens for Tailwind theme JSON or W3C DTCG token JSON for downstream implementation.

Do I need YAML front matter to validate my design system spec?

Yes, YAML front matter is required to produce a compliant design system spec. The validation process requires YAML front matter, token references, section-order validation, and WCAG contrast checks for compliant outputs.

How do design tokens work with W3C DTCG format exports?

Design tokens are exported to W3C DTCG format by converting the validated DESIGN.md specification into W3C DTCG token JSON. This allows downstream tools and coding agents to share one source of truth for brand and UI decisions.

Why does my DESIGN.md fail section-order validation?

Your DESIGN.md fails section-order validation when canonical narrative sections are not in the required sequence. The validation enforces strict section ordering alongside token reference and value format linting to produce compliant outputs.