Validate your DESIGN.md against the Google spec
Lint structure, check WCAG contrast, find broken token references, and export to Tailwind — using the official @google/design.md CLI. Always the latest version, zero config.
npx skills add https://github.com/fabricioctelles/skills -s design-md-validator Powered by @google/design.md — 26k+ ⭐ on GitHub • Official Spec
View full documentation →What it validates
broken-ref Token references that don’t resolve to any defined token
missing-primary Colors defined but no primary color exists
contrast-ratio Component backgroundColor/textColor pairs below WCAG AA minimum (4.5:1)
orphaned-tokens Color tokens defined but never referenced by any component
token-summary Summary of how many tokens are defined in each section
missing-sections Optional sections (spacing, rounded) absent when other tokens exist
missing-typography Colors defined but no typography tokens exist
section-order Sections appear out of the canonical order defined by the spec
unknown-key A top-level YAML key looks like a typo of a known schema key (e.g. colours: → colors:)
token-like-ignored next release A top-level YAML key that looks like a design-token map but is not part of the recognized schema and will be silently ignored
More skills from this repo
9 skillsagent-ready-cloudflare
Audits any website for AI agent readiness — 18 checks across 5 categories with fix prompts.
ultimate-design-system-master
Creates comprehensive design systems, brand identities, and UI component libraries.
loop-architect
Designs well-structured agent loops with review gates, cross-model councils, and portable artifacts.
security-specialist
Security audit with 6-phase pipeline, 9 attack classes and adversarial validation.
auth-md
Generates and validates auth.md — the open protocol for AI agent registration in services.
okf-open-knowledge-format
Creates, validates and enriches OKF bundles — the "LLM Wiki" pattern as a formal spec.
geo-optimization
Optimizes content for citation by LLMs and generative search engines.
startup-idea
Complete startup analysis with Paul Graham + Dan Koe + Seth Godin frameworks.
humanizar
Rewrites Brazilian Portuguese text to sound human and undetectable by AI detectors.
Install all skills at once:
npx skills add https://github.com/fabricioctelles/skills Full catalog at skilldev.pro →
Compatible with: Claude Code • Cursor • Kiro • Windsurf • Codex • Gemini CLI