design-align

Audit React component Tailwind classes against the FirstWho design system.

Updated Mar 14, 2026
One-click install
npx skills add https://github.com/ryan-mahoney/ryan-llm-skills --skill design-align
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: design-align
Source: https://github.com/ryan-mahoney/ryan-llm-skills/tree/main/skills/design-align
Command: npx skills add https://github.com/ryan-mahoney/ryan-llm-skills --skill design-align

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Audits a React component tree to ensure styling and layout conform to the FirstWho design system, reducing design drift and rework across UI components.

Core Features & Use Cases

  • Audit a top-level component and all its descendants to map class usage to design tokens.
  • Produce a grouped checklist of Tailwind CSS corrections and propose concrete updates.
  • Reference design-system tokens from docs/design/design-system.md and the Tailwind configuration to guide changes.
  • Apply approved changes to bring UI in line with the design system and improve consistency.

Quick Start

Provide the path to the top-level React component to begin auditing and aligning it to the design system.

Frequently Asked Questions about design-align

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

FAQPage Schema
How do I audit Tailwind classes against a design system in React components?

To audit Tailwind classes, provide the path to a top-level React component. The tool maps its subtree to design tokens, generates a grouped checklist of CSS corrections, and proposes changes aligned with your design system.

How do I fix UI consistency issues and design drift in a React component tree?

Fix UI consistency by auditing your React component tree against design system tokens. The tool identifies class usage mismatches and produces a concrete checklist of Tailwind CSS corrections to resolve design drift.

What's the best way to map React component Tailwind usage to design tokens for consistency?

The best way to map Tailwind usage is referencing design-system tokens from docs and configuration files. The tool audits each component's classes against these tokens to outline a clear plan for approved updates.

Do I need a tailwind.config.js and design-system.md to audit my React UI components?

Yes, the audit references design tokens from docs/design/design-system.md and tailwind.config.js. These files define the baseline rules used to map your React component classes and generate grouped CSS corrections.

Can I audit a specific React component subtree instead of the entire application UI?

Yes, you can audit a specific React component subtree. Provide the path to the top-level component, and the tool will map all its descendants to the design system and check their Tailwind classes for consistency.

Why does my Tailwind CSS not match the FirstWho design system tokens?

Tailwind CSS may not match design tokens due to design drift across UI components. The tool audits your component tree, identifies class usage that deviates from the FirstWho design system, and proposes updates to fix inconsistencies.