design-md

What problem does it solve? Maintaining a consistent visual identity across projects and coding agents is hard when design decisions live in scattered style guides. This Skill produces a single DESIGN.md file following Google's open spec, combining machine-readable YAML design tokens with human-readable rationale, and validates it for structural errors and WCAG contrast issues. ## Core Features & Use Cases - Authoring: Generate a complete DESIGN.md with colors, typography, spacing, rounded corners, and component tokens using token references like {colors.primary}. - Linting and Diffing: Run the @google/design.md CLI via npx to catch broken token references, duplicate sections, invalid values, and WCAG AA/AAA contrast failures, and diff versions for regressions. - Exporting: Convert the spec to Tailwind theme JSON or W3C DTCG design tokens JSON for direct use in existing projects. - Use Case: A team wants every AI coding agent to apply the same brand. You create a DESIGN.md in the project root, lint it to confirm contrast compliance, and export tailwind.theme.json so the design system is enforced everywhere. ## Quick Start Create a DESIGN.md design token spec for my brand with a blue accent color and Inter typography, then lint it for WCAG contrast issues.