schema-validator

Validate design token files against DTCG, Style Dictionary, or Tokens Studio schemas.

155|7|Updated Mar 9, 2026
One-click install
npx skills add https://github.com/murphytrueman/design-system-ops --skill schema-validator
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: schema-validator
Source: https://github.com/murphytrueman/design-system-ops/tree/main/skills/schema-validator
Command: npx skills add https://github.com/murphytrueman/design-system-ops --skill schema-validator

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill prevents build failures and silent errors by validating that design token files adhere to specified structural formats, catching issues before they impact downstream processes.

Core Features & Use Cases

  • Format Validation: Checks token files against DTCG, Style Dictionary (v3/v4), Tokens Studio, or custom schemas.
  • Error Detection: Identifies missing required properties, incorrect alias syntax, invalid values, and structural inconsistencies.
  • Use Case: Before merging a change to your design tokens, run this skill to ensure all new or modified token files are correctly formatted and won't break the build pipeline.

Quick Start

Validate all token files in the 'tokens/' directory against the DTCG 2025.10 schema.

Frequently Asked Questions about schema-validator

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

FAQPage Schema
How do I validate design tokens against the DTCG schema?

To validate design tokens against the DTCG schema, parse your JSON, YAML, or JS files to check structural integrity and alias syntax. This detects missing required properties and incorrect values before they impact downstream build pipelines.

Why does Style Dictionary fail to build my design token files?

Style Dictionary build failures often occur due to incorrect alias syntax, invalid values, or missing required properties in design token files. Validating structural integrity beforehand detects these issues and provides actionable remediation guidance.

Can I check Tokens Studio files for missing required properties?

Yes, you can check Tokens Studio files for missing required properties by validating them against specified schemas. The process parses JSON, YAML, or JS files to inventory token structures and identify any missing properties or invalid values.

What is the best way to prevent silent errors in design token JSON files?

The best way to prevent silent errors in design token JSON files is to validate them against structural schemas like DTCG 2025.10. This catches incorrect alias syntax and structural inconsistencies early, producing a detailed validation report with remediation guidance.

Does design token validation work with YAML and JS files?

Yes, design token validation works with YAML and JS files, alongside JSON. The validation process parses and inventories these file formats to detect structural integrity issues and incorrect alias syntax against specified schemas like DTCG or Style Dictionary.