ui-design

Guides frontend UI design decisions covering layout, components, accessibility, and WCAG 2.2 AA compliance.

1|Updated Apr 24, 2026
One-click install
npx skills add https://github.com/kreek/consult --skill ui-design-kreek
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: ui-design
Source: https://github.com/kreek/consult/tree/main/plugin/skills/ui-design
Command: npx skills add https://github.com/kreek/consult --skill ui-design-kreek

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Frontend interfaces often ship with unclear hierarchy, missing loading and error states, one-off styling values, and accessibility gaps that automated tools only partially catch. This Skill gives coding agents a concrete rule set and reference library for building, changing, and reviewing user-facing UI so screens stay task-focused, consistent, and WCAG 2.2 AA compliant. ## Core Features & Use Cases - Design rules and tripwires: Nine enforceable rules covering visual hierarchy, design tokens, state coverage, semantic HTML, focus visibility, and form accessibility, plus a tripwire table that redirects common anti-patterns like styled-div buttons and positive tabindex. - Deep reference library: On-demand references for WCAG 2.2 criteria and ARIA patterns, Swiss/Rams design canon, modern CSS features, typography, framework tradeoffs (Svelte, React, Vue, Astro), and platform guidelines (Apple, Material, Fluent, government design systems). - Use Case: When asked to add a modal dialog to a settings page, the Skill directs the agent to use native <dialog> with .showModal(), restore focus on close, define loading and error states, and verify keyboard flow rather than hand-rolling a focus trap. ## Quick Start Use the ui-design skill to review this settings page for hierarchy, missing states, and WCAG 2.2 AA accessibility issues.

Frequently Asked Questions about ui-design

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

FAQPage Schema
How do I make a modal dialog accessible in HTML?▼

Use the native <dialog> element with .showModal(), which handles focus trapping and inert background content automatically. Set aria-labelledby to the dialog heading and restore focus to the invoking element on close; manual focus traps are outdated for modern browsers.

What WCAG 2.2 criteria apply to frontend UI development?▼

Key criteria include 1.4.3 contrast (4.5:1 body text), 1.4.10 reflow to 320px, 1.4.11 non-text contrast at 3:1, 2.4.7 focus visible, 2.5.8 target size minimum of 24x24 CSS px, and 3.3.8 accessible authentication without cognitive tests. WCAG 2.2 AA is the baseline floor.

Should I use ARIA attributes or semantic HTML elements?▼

Prefer native HTML elements like <button>, <a href>, and <dialog> before adding ARIA. WebAIM data shows sites using ARIA average 41% more detected accessibility errors, so no ARIA is better than incorrect ARIA on repurposed elements.

Svelte vs React: which frontend framework should I choose?▼

Svelte with SvelteKit is the default pick for compile-time reactivity and small bundles. Choose React with Next.js when the team already knows React, hiring pool matters, or the shadcn/ui and Radix ecosystem is explicitly required.

Why do automated accessibility tools miss some issues?▼

Automated tools like axe-core catch roughly 30-57% of issues because they cannot judge meaningful labels, focus order intent, or keyboard model correctness on custom widgets. Manual keyboard testing and screen-reader passes with NVDA, VoiceOver, or TalkBack remain necessary.

When should I not use this UI design guidance?▼

It does not cover backend API design, frontend runtime debugging, or performance profiling beyond UI design choices. Pair it with testing and performance skills for browser-verified flows and Core Web Vitals work.