design-system

Validate design token accessibility and consistency across Tailwind, MUI, Chakra, and shadcn.

Updated Aug 16, 2025
One-click install
npx skills add https://github.com/dodyg/blue-nile-pds --skill design-system-dodyg
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: design-system
Source: https://github.com/dodyg/blue-nile-pds/tree/main/.agents/skills/design-system
Command: npx skills add https://github.com/dodyg/blue-nile-pds --skill design-system-dodyg

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Color token contrast computation, framework token paths, and focus ring validation to ensure WCAG AA/AAA compliance before tokens reach deployed UI.

Core Features & Use Cases

  • Color contrast evaluation across tokens and UI components to prevent accessibility violations.
  • Framework token path references for Tailwind/MUI/Chakra/shadcn to standardize token usage.
  • Focus ring validation and adherence to WCAG 2.4.13 focus appearance guidelines.
  • Motion and spacing token audits to ensure touch-target compliance and consistent motion behavior.
  • Use case: validate a design system before integrating into a live UI to reduce rework and accessibility defects.

Quick Start

Validate your design tokens by running the validation engine on your token set to confirm color contrast, focus ring compliance, and consistent token paths before deploying UI.

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 tokens for WCAG color contrast compliance?

Validate design tokens for WCAG color contrast compliance by running a validation engine that computes contrast ratios across your token set and UI components. The engine evaluates color pairs against explicit reference rules to enforce AA and AAA accessibility standards before deployment.

How do I check focus ring compliance against WCAG 2.4.13 guidelines?

Check focus ring compliance against WCAG 2.4.13 guidelines by validating focus appearance using the skill's reference rules. The validation engine audits focus ring tokens to ensure adherence to accessibility standards and prevent focus state violations before UI deployment.

Does design token validation work with Tailwind, MUI, Chakra, and shadcn token paths?

Design token validation works with Tailwind, MUI, Chakra, and shadcn token paths by providing framework-specific token path references. This standardizes token usage across different frameworks and ensures consistent accessibility validation regardless of the UI library.

What is the best way to audit motion and spacing tokens for touch-target compliance?

The best way to audit motion and spacing tokens for touch-target compliance is to run validation checks that evaluate spacing targets and motion token behavior. This ensures consistent motion patterns and verifies that spacing meets accessibility touch-target requirements.

Why validate design tokens before integrating them into a live UI?

Validate design tokens before integrating them into a live UI to reduce rework and accessibility defects. Early validation catches color contrast failures, focus ring violations, and inconsistent token paths before they propagate to deployed components, saving development time.

What limitations exist when validating design system tokens for accessibility?

Limitations when validating design system tokens for accessibility include dependency on accurate token definitions and framework-specific path configurations. The validation focuses on WCAG AA and AAA standards, meaning custom accessibility requirements beyond these guidelines may need additional manual evaluation.