theme-audit

Audit design system theme coverage, consistency, and component tier propagation.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill identifies and rectifies inconsistencies in design system themes, ensuring that visual elements render correctly across different modes like light, dark, or brand variants. It prevents visual bugs and maintains a cohesive user experience.

Core Features & Use Cases

  • Theme Coverage Audit: Detects missing tokens in specific themes.
  • Component Tier Propagation Check: Verifies that component tokens correctly inherit from semantic tokens across themes, preventing "tier leakage."
  • Visual Consistency Validation: Checks for logical visual errors within each theme (e.g., contrast ratios, color hierarchy).
  • Regression Risk Assessment: Identifies patterns in code that may break during theme switches.
  • Use Case: After launching a new dark mode, use this Skill to automatically scan all your tokens and components to ensure every element has a corresponding dark mode value and that no unexpected visual glitches appear.

Quick Start

Run an audit of all themes in the current project.

Frequently Asked Questions about theme-audit

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

FAQPage Schema
How do I audit design system tokens for missing values across light and dark themes?

To audit design system token coverage, scan all components against your defined themes to detect missing tokens, identify tier leakage, and validate visual consistency. This ensures every element has a corresponding value across light, dark, and brand variants.

What is component tier leakage in a design system?

Component tier leakage occurs when component tokens fail to correctly inherit from semantic tokens across different themes. Auditing this propagation verifies that tokens map correctly, preventing visual inconsistencies when switching between light, dark, or brand modes.

How do I check my design system for regression risks from hardcoded CSS values?

To check design system regression risks, scan your codebase for hardcoded values and incorrect CSS usage that may break during theme switches. This assessment identifies patterns that fail to resolve properly through DTCG configurations.

Does this design system audit validate DTCG resolver configurations?

Yes, the design system audit validates DTCG resolver configurations to ensure tokens resolve correctly. It assesses resolver setups alongside hardcoded values to identify patterns that may cause visual glitches during light, dark, or brand theme switches.

When do I need to run a design system theme consistency audit?

You need to run a theme consistency audit after launching a new mode like dark mode, updating semantic tokens, or adding brand variants. It automatically scans tokens and components to catch missing values and prevent unexpected visual bugs.