design-md-format

Create and validate DESIGN.md design system files with WCAG contrast checks.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It turns ambiguous design-system documentation into a consistent, machine-readable DESIGN.md that AI coding agents can reliably understand and validate.

Core Features & Use Cases

  • Validate DESIGN.md against a spec: catch broken token references, enforce canonical section order, and detect missing required tokens like primary.
  • Ensure accessibility correctness: compute WCAG contrast for token-defined component color pairs and surface issues as warnings/errors.
  • Export design tokens for implementation: convert DESIGN.md tokens to formats like Tailwind (v3 JSON or v4 CSS) and DTCG for downstream tooling and theming.

Quick Start

Ask your AI agent: "Create a DESIGN.md for our product design system, then lint it and export the tokens to Tailwind v4 CSS."

Frequently Asked Questions about design-md-format

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

FAQPage Schema
How do I lint design tokens for broken references and WCAG contrast issues?

Lint design tokens by validating a DESIGN.md YAML front matter schema against canonical section ordering, checking token reference integrity, and computing WCAG contrast for component color pairs to surface accessibility warnings.

What is a DESIGN.md file for a design system?

A DESIGN.md file is a structured, machine-readable design system specification that encodes validated tokens and human rationale for AI agents to reliably understand and maintain.

Can I export design tokens from markdown to Tailwind CSS?

Yes, you can export validated DESIGN.md tokens to implementation targets like Tailwind v3 JSON, Tailwind v4 CSS, and DTCG formats for downstream tooling and theming.

How do I validate that my design system markdown has all required tokens?

Validate your design system markdown by running linter checks that detect missing required tokens like primary, enforce canonical section order, and flag broken token references.

Does the DESIGN.md linter check accessibility contrast ratios automatically?

Yes, the DESIGN.md linter computes WCAG contrast for token-defined component color pairs and automatically surfaces accessibility violations as warnings or errors.

What format does the design token schema need to be in for linting?

The design token schema needs to be in YAML front matter within the DESIGN.md file, containing correct token references for the linter to validate integrity and structure.