design-system

Validate DESIGN.md tokens against the canonical Google spec.

2|Updated Apr 22, 2026
One-click install
npx skills add https://github.com/coroboros/agent-skills --skill design-system-coroboros
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: design-system
Source: https://github.com/coroboros/agent-skills/tree/main/skills/design-system
Command: npx skills add https://github.com/coroboros/agent-skills --skill design-system-coroboros

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires npx, @google/design.md, and includes scripts (resource) components.

What problem does it solve?

This Skill governs the integrity of DESIGN.md by validating tokens against the canonical Google DESIGN.md spec and surfacing actionable governance findings.

Core Features & Use Cases

  • Auto-enforce YAML token sources and section structure in DESIGN.md during UI edits and code changes.
  • Provide wrapper tooling for audit, diff, export, and migrate flows to maintain token consistency across projects.
  • Integrate CLI-based validation to catch broken references, drift, and token-misalignments, with guidance for remediation.

Quick Start

Run the governance workflow to audit DESIGN.md and surface actionable findings.

Frequently Asked Questions about design-system

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I validate DESIGN.md files against the canonical Google design-token spec?

Validate DESIGN.md by running the provided CLI wrapper tooling to check YAML frontmatter, required fields, token references, and section ordering against the Google spec, surfacing actionable governance findings for remediation.

What is the best way to audit design tokens for drift across multiple apps and teams?

Audit design tokens for drift using the integrated CLI tooling to catch broken references and token misalignments in DESIGN.md, providing guidance to maintain token consistency across multiple apps, editors, and teams.

Can I use npx to enforce design-token governance during UI edits?

Yes, you can use npx to run the CLI validation tooling and auto-enforce YAML token sources and section structure in DESIGN.md during UI edits and code changes to maintain brand design system integrity.

How do I migrate or export design tokens from a DESIGN.md file?

Migrate or export design tokens from DESIGN.md using the wrapper tooling that supports audit, diff, export, and migrate workflows, enabling token consistency across different projects and editors.

Do I need @google/design.md to run design-token validation workflows?

Yes, @google/design.md is a required dependency for validating DESIGN.md files, as it provides the canonical spec used to check YAML frontmatter, token references, and section ordering to enforce token governance.

Why does design-token validation fail on broken references in DESIGN.md?

Design-token validation fails on broken references when the CLI tooling detects token misalignments or drift during the audit workflow, surfacing actionable findings to guide remediation and ensure valid YAML structure.