design-md

Lint DESIGN.md files for token structure and WCAG compliance.

12|2|Updated Feb 2, 2020
One-click install
npx skills add https://github.com/servitola/dotfiles --skill design-md-servitola
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: design-md
Source: https://github.com/servitola/dotfiles/tree/main/claude-code/skills/design-md
Command: npx skills add https://github.com/servitola/dotfiles --skill design-md-servitola

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

DESIGN.md tokens enable precise, machine-readable design specifications and automated validation across projects, ensuring consistency and accessibility.

Core Features & Use Cases

  • Lint and validate token structure, references, and WCAG contrast.
  • Diff versions to identify regressions and export to Tailwind or DTCG JSON.
  • Use Case: teams exporting design tokens for a new UI library or auditing an existing DESIGN.md file.

Quick Start

Run the DESIGN.md skill to lint a DESIGN.md file and generate a token export.

Frequently Asked Questions about design-md

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

FAQPage Schema
How do I lint and validate design tokens for WCAG contrast compliance?

Lint DESIGN.md files to validate token structure, references, and WCAG contrast compliance, ensuring accessible design specifications. The tool audits canonical sections and token references, generating actionable validation errors for quick resolution.

Can I export design tokens to Tailwind config or DTCG JSON format?

Export validated DESIGN.md token structures to Tailwind config or DTCG JSON format for downstream tooling integration. The tool translates canonical token references into framework-specific configuration files for UI library consumption.

What is the best way to detect design token regressions between versions?

Diff DESIGN.md file versions to detect token regressions by comparing structural changes and WCAG contrast compliance across iterations. The diffing process identifies regressions in canonical sections and token references to prevent accessibility issues.

Do I need a specific framework to audit an existing DESIGN.md file?

No framework dependency is required to audit an existing DESIGN.md file. The validation process checks token structure, references, and WCAG compliance independently, enabling export to Tailwind or DTCG JSON after successful validation.

When do I need to validate DESIGN.md token structure and references?

Validate DESIGN.md token structure and references when authoring new UI libraries or auditing existing design specifications for consistency. Validation enforces canonical sections and WCAG compliance before exporting tokens to downstream tooling.