design-md-validator
This skill validates DESIGN.md files using Google's @google/design.md specification, catching structural errors, broken token references, and design-system quality issues. It runs a bundled Node script to lint YAML front matter, component properties, and WCAG contrast ratios, then reports findings with actionable fixes. Use it to verify design tokens before shipping or to compare versions for regressions.
design-md-validator lints DESIGN.md files against Google's design.md specification to catch errors and compliance issues.
AI-generated summary based on this skill's SKILL.md
Decision gist · record as of 2026-07-28
design-md-validator lints DESIGN.md files against Google's design.md specification to catch errors and compliance issues. This skill validates DESIGN.md files using Google's @google/design.md specification, catching structural errors, broken token references, and design-system quality issues. It runs a bundled Node script to lint YAML front matter, component properties, and WCAG contrast ratios, then reports findings with actionable fixes. Use it to verify design tokens before shipping or to compare versions for regressions.
Use it when
- design-md-validator's primary function is to lint DESIGN.md files for errors.
- Yes.
Verify before relying
Read SKILL.md below before installing (6 files). Open directory: indexed for reading, not audited.
Install
Mineru98/skills-store/design-md-validator · repository language: JavaScript
Open directory. Skills are indexed for reading, not audited. Review a skill's body before installing it.
Frequently asked questions
AI-generated answers based on this skill's SKILL.md and metadata
What does design-md-validator do?
design-md-validator validates DESIGN.md files using Google's @google/design.md specification, catching structural errors, broken token references, and design-system quality issues. It runs a bundled Node script to lint YAML front matter, component properties, and WCAG contrast ratios, then reports findings with actionable fixes.
How do I lint design.md for errors?
design-md-validator's primary function is to lint DESIGN.md files for errors. Run the skill to scan your DESIGN.md file; it will check YAML front matter syntax, component property validity, token references, and WCAG contrast compliance, returning a detailed report of any issues found.
Can design-md-validator check design tokens YAML validation?
Yes. design-md-validator validates design tokens YAML by checking for missing or broken references, verifying that all token definitions are well-formed and properly linked throughout your design system specification.
Does design-md-validator compare two DESIGN.md versions?
Yes. design-md-validator can compare two DESIGN.md versions to detect regressions, helping you identify structural changes, removed tokens, or compliance drift between design system iterations.
What compliance checks does design-md-validator perform?
design-md-validator verifies WCAG contrast ratios on design tokens and validates component property definitions against the @google/design.md specification, ensuring your design system meets accessibility and structural standards.
Can design-md-validator find design system files in my workspace?
Yes. design-md-validator can discover and audit design system files in your workspace, making it easy to locate all DESIGN.md files and related token definitions that need validation.
SKILL.md
Rendered from the published skill. Quoted content, verbatim.
DESIGN.md Validator
Overview
Validate DESIGN.md files before using them as design-system source of truth. Prefer the bundled script for repeatable checks, then interpret the JSON findings into concrete fixes.
(truncated - see the full file via the links below)
File tree — 6 files
.codex/skills/design-md-validator/SKILL.md
.codex/skills/design-md-validator/agents/openai.yaml
.codex/skills/design-md-validator/references/design-md-spec-summary.md
.codex/skills/design-md-validator/references/lint-rules.md
.codex/skills/design-md-validator/references/spec-checklist.md
.codex/skills/design-md-validator/scripts/validate_design_md.mjs
Let your AI agent find skills like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 56,283 agent skills by what they can do, searchable in plain language.
wish › “Validate and lint DESIGN.md files for errors and compliance”
Give your agent the search over MCP, or paste the wish link into any chat. No install? Search from any chat →
Related skills
design-md lets you create and validate DESIGN.md files—Google's open spec for encoding design systems as machine-readable tokens plus human-readable rationale. The included CLI lints structure, checks WCAG color contrast, diffs versions for regressions, and exports to Tailwind or W3C DTCG JSON formats.
design-md helps you create and maintain formal design token specifications using Google's open DESIGN.md format. Write machine-readable tokens in YAML paired with human-readable guidance, then lint for WCAG contrast compliance, diff versions for regressions, and export to Tailwind or W3C DTCG JSON formats.
Design System converts visual references into two synchronized outputs: a YAML token spec in Google's design.md format for coding agents, and a self-contained HTML style guide for human review. Reads imagery, derives tokens for color, typography, spacing, and components, then generates both files as a single source of truth that never drifts.
design-spec is a guide to creating DESIGN.md, the single source of truth for a project's visual language. It covers the YAML token schema (colors, typography, spacing, rounded, components), type system, token references, and canonical section order—all required before writing any UI code. Use it when defining design tokens or establishing a design source-of-truth for web or mobile projects.
Design Spec Extraction converts visual inputs—screenshots, mockups, and design exports—into structured JSON specifications following W3C Design Tokens standards. The skill uses a 7-pass serial architecture to extract layout, colors, typography, components, spacing, accessibility data, and state information, writing each phase to disk for validation and resumption.
Design Tokens manages design token files using the DTCG 2025.10 standard with a dependency-free Python core. It scaffolds token sets, validates them against the spec, merges project overrides with global brand bases, resolves aliases, and exports to CSS custom properties. The skill also generates preview pages, design documentation, and generation prompts for on-brand image creation.