design-md

Lint, diff, and export DESIGN.md token specification files.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

DESIGN.md token specs are the source of truth for design tokens; this skill helps author, validate, and migrate them into usable formats for tooling and design systems.

Core Features & Use Cases

  • Lint DESIGN.md for structural validity, token references, and WCAG-related checks.
  • Diff two DESIGN.md versions to spot regressions and enforce compatibility.
  • Export tokens to Tailwind theme or W3C DTCG JSON for integration with tooling and design systems.

Quick Start

Place 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 a DESIGN.md file for structural validity and token references?

To lint a DESIGN.md file, place it in your project root and run the lint command to validate YAML frontmatter, enforce canonical sections, and check token references for predictable tooling behavior.

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

Yes, you can export design tokens from DESIGN.md to a Tailwind theme or W3C DTCG JSON format, enabling direct integration of token specifications into your tooling and design systems.

What is the best way to diff two DESIGN.md versions for design token regressions?

Diffing two DESIGN.md versions spots regressions and enforces compatibility by comparing token specifications, ensuring that structural changes maintain token integrity across different project versions.

Does the DESIGN.md lint check WCAG compliance for design tokens?

Yes, linting DESIGN.md files includes WCAG-related checks to ensure that your design token specifications meet accessibility standards alongside structural and token reference validation.

What format does DESIGN.md require for YAML frontmatter?

DESIGN.md requires YAML frontmatter to include both name and description fields, which enforces canonical sections and maintains predictable tooling behavior across your design system.