What problem does it solve? Design systems are often documented informally, leaving AI coding agents without structured, machine-readable guidance on colors, typography, spacing, and components. This Skill provides the DESIGN.md format specification and CLI tooling to author, validate, compare, and export design tokens so agents and developers share a single source of truth. ## Core Features & Use Cases - Structured Token Authoring: Define colors, typography, rounded corners, spacing, and component tokens in YAML front matter paired with human-readable markdown rationale sections. - Linting and Validation: Run the CLI linter to catch broken token references, missing primary colors, orphaned tokens, section order issues, and WCAG AA contrast ratio failures. - Export and Diff: Convert tokens to Tailwind v3 JSON, Tailwind v4 CSS, or W3C DTCG format, and diff two DESIGN.md versions to detect token changes and regressions. - Use Case: A team codifies its brand guidelines into a DESIGN.md file, validates it in CI with the lint command, and exports tokens directly into their Tailwind configuration so generated UI code always matches the design system. ## Quick Start Ask the agent to create a DESIGN.md file for your design system with primary colors, typography, and button component tokens, then lint it for WCAG contrast issues.
