design-system-reviewer

Analyze frontend components for design system token compliance and hardcoded values.

1|Updated Mar 23, 2026
One-click install
npx skills add https://github.com/RaNDoM6913/claude-code-superkit --skill design-system-reviewer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: design-system-reviewer
Source: https://github.com/RaNDoM6913/claude-code-superkit/tree/main/packages/codex/skills/design-system-reviewer
Command: npx skills add https://github.com/RaNDoM6913/claude-code-superkit --skill design-system-reviewer

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Frontend UI components often fail to align with a project's design system tokens, leading to visual inconsistencies and potential accessibility gaps. This Skill helps detect token usage automatically and enforces reliance on tokens rather than hardcoded values.

Core Features & Use Cases

  • Design Token Discovery: automatically detect design tokens from CSS variables, Tailwind/theme configs, and design-token files.
  • Token-Based Compliance: verify colors, spacing, typography, and z-index use tokens instead of hardcoded values.
  • Use Case: run a full design-system audit across a component library to produce a report that highlights deviations and suggested token substitutions.

Quick Start

Prompt the reviewer with your component library path to begin the token-based review process.

Frequently Asked Questions about design-system-reviewer

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

FAQPage Schema
How do I audit frontend components for hardcoded values instead of design tokens?

Audit frontend components by scanning for hardcoded colors, spacing, and typography to enforce design token usage. The reviewer analyzes your component library to detect non-compliant values and generates a report highlighting deviations with suggested token substitutions.

Can I automatically discover design tokens from Tailwind configs and CSS variables?

Yes, you can automatically discover design tokens from Tailwind theme configs, CSS variables, and design-token files. The reviewer detects these tokens to build a token map, ensuring subsequent component checks validate against your project's actual defined styles.

What is design system token compliance and why does it matter for accessibility?

Design system token compliance ensures UI components use predefined variables for colors, spacing, and typography rather than hardcoded values. Maintaining this compliance prevents visual inconsistencies and closes potential accessibility gaps across multiple environments.

How do I generate a token map for a UI component library?

Generate a token map by pointing the reviewer at your component library path. It automatically extracts design tokens from your CSS variables and theme configurations to produce a structured mapping for validating component conformance.

Does the design system reviewer work across multiple files and environments?

Yes, the design system reviewer works across multiple files and environments. You can apply it to UI component libraries and design audits to validate token usage and check accessibility conformance throughout your entire project structure.

What is the best way to check z-index and spacing token usage in UI components?

The best way to check z-index and spacing token usage is running a token-based compliance review. The reviewer verifies these properties against your design system tokens to identify hardcoded values and suggest proper substitutions.