ui-design-principles

Evaluate UI code against a senior design rubric across hierarchy, spacing, color, typography, motion, density, components, and accessibility.

Updated May 6, 2026
One-click install
npx skills add https://github.com/shipiit/shipit-ui-design --skill ui-design-principles-shipiit
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ui-design-principles
Source: https://github.com/shipiit/shipit-ui-design/tree/main/skills/ui-design-principles
Command: npx skills add https://github.com/shipiit/shipit-ui-design --skill ui-design-principles-shipiit

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

It eliminates inconsistent, hard-to-read UI by applying a comprehensive, repeatable rubric for hierarchy, spacing, color/contrast, typography, motion, density, component quality, and accessibility—then scoring the results so you know what to fix first.

Core Features & Use Cases

  • Rubric-driven UI evaluation (0–100): Produces category scores and an overall total, with a clear threshold (85) for “needs more work.”
  • Design-system-safe guidance: Enforces token-only values for colors, spacing, radii, shadows, and motion so output stays consistent with the project’s stack and tokens.
  • State coverage and accessibility checks: Requires hover/active/focus-visible/disabled states, reduced-motion respect, dark mode parity, and semantic/ARIA correctness.
  • Task scenarios: Used when generating, refining, or auditing UI in .tsx/.jsx/.vue/.svelte files, especially for components, audits, and visual critique loops.

Quick Start

Apply the UI design rubric to your current React/TSX (or Vue/Svelte) component by asking Claude to score it per the categories and propose tokenized fixes that cover all interactive states and accessibility requirements.

Frequently Asked Questions about ui-design-principles

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

FAQPage Schema
How do I audit my React component for UI design consistency and accessibility?

You can audit React component UI by applying a rubric-driven evaluation that scores hierarchy, spacing, color contrast, typography, motion, and accessibility from 0 to 100, flagging any output below 85 for refinement.

What is the best way to enforce design tokens for spacing and color in TSX components?

The best way to enforce design tokens in TSX components is to use an evaluation rubric that requires token-only values for colors, spacing, radii, shadows, and motion, ensuring output stays consistent with your project's stack.

How do I check if my Vue or Svelte UI covers all interactive states and dark mode parity?

You can check interactive state coverage and dark mode parity by auditing the UI code against a design rubric that validates hover, active, focus-visible, and disabled states alongside reduced-motion respect and semantic ARIA correctness.

Does a UI design rubric work for evaluating dashboard and chart surfaces in Svelte?

Yes, a UI design rubric applies to evaluating dashboard and chart-like surfaces in Svelte, assessing density, component quality, and visual hierarchy to identify what needs improvement across the interface.

Why does my generated UI score poorly on typography and color contrast audits?

Generated UI often scores poorly on typography and color contrast audits when it lacks token-only design values, fails accessibility constraints, or misses full interactive state coverage required by a senior design rubric.

Can I use a senior design rubric to refine existing JSX component code?

Yes, you can use a senior design rubric to refine existing JSX component code by scoring it across hierarchy, spacing, and component quality, then applying tokenized fixes that cover all required interactive states and accessibility requirements.