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.