ui-design

Specifies, audits, and hands off visual design using semantic design tokens.

Updated Nov 20, 2025
One-click install
npx skills add https://github.com/apuya/react-basics-ui --skill ui-design-apuya
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: ui-design
Source: https://github.com/apuya/react-basics-ui/tree/main/.claude/skills/ui-design
Command: npx skills add https://github.com/apuya/react-basics-ui --skill ui-design-apuya

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? It ensures visual consistency across a UI by applying an established design-token system for color, typography, spacing, and states, catching off-system values, contrast failures, and dark-mode parity issues before they ship. ## Core Features & Use Cases - Visual Spec Mode: Assigns semantic tokens for palette, type scale, spacing rhythm, and state looks to new screens built on an existing UX brief. - Audit Mode: Reviews built UIs across six dimensions (hierarchy, color, typography, spacing, states, dark mode) with tiered Blocker/High/Medium findings citing the violated rule. - Figma Handoff Mode: Maps raw Figma values (hex, px, weights) to semantic token names and flags states missing from the file, such as dark theme or disabled variants. - Use Case: A developer finishes a new settings page in react-basics-ui and asks for a visual review; the skill audits contrast in both light and dark themes, flags an off-scale 13px gap, and reports findings by severity. ## Quick Start Ask the skill to audit the visual design of a specific screen or component, or to produce a visual spec from an existing UX brief.

Frequently Asked Questions about ui-design

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

FAQPage Schema
How do I audit a UI for visual design issues?▼

Run the audit mode against the built surface. It scores six dimensions — hierarchy, color, typography, spacing, states, and dark mode — and reports findings as Blocker, High, or Medium, each citing the specific visual rule violated and a concrete fix.

How do I convert Figma designs to design tokens?▼

Provide the Figma URL and the handoff mode extracts raw values like hex colors, font sizes, and spacing, then maps each to a semantic token name. Values with no token equivalent are flagged as open questions rather than inlined as raw values.

What contrast ratios are required for text and UI elements?▼

Body text requires at least 4.5:1 against its background, large or bold UI text at least 3:1, and non-text elements like icons and focus rings at least 3:1 against neighbors. Contrast must be verified in both light and dark themes.

Does this skill create wireframes or user flows?▼

No. Wireframes, user flows, information architecture, and interaction patterns are explicitly out of scope as UX work. The skill only handles visual treatment — color, typography, spacing, states, illustration, and iconography — after UX structure is settled.

Why does my dark mode design look broken compared to light mode?▼

Dark mode failures usually come from colors that pass contrast in light theme but fail in dark, or adjacent surfaces losing relative contrast so edges disappear. Every color token needs a dark counterpart that preserves relative contrast and warmth.