Skip to content

lidge-jun/codexclaw / plugins/codexclaw/skills/dev-uiux-design

cxc-dev-uiux-design

Verified

Use for UI/UX and brand direction. Triggers: make it look good, onboarding, empty state, error state, favicon, logo, design system, 깔끔하게, 모던하게, 감성적으로.

references/ux-preflight.md

View on GitHub
# UX Preflight Checklist

Run this checklist **before delivery** of any UI feature. Each item is a binary pass/fail.

---

## Constraint / Property Requirements

These labels are delivery requirements, never aesthetic directions.

- **low-carbon:** Set and verify an explicit transfer, media, font, script, animation, and caching budget appropriate to the product. Do not use `low-carbon` as a synonym for Minimalism or as a visual claim without measured delivery evidence.
- **responsive:** Require usable hierarchy, content, navigation, targets, and interaction across supported viewports and input modes. This is a product property, not a style. Verification remains owned by `## Responsive Verification` below; declaring the tag does not satisfy its 390px/768px/1440px, overflow, target-size, or navigation checks.

## 1. State Coverage

| State | Check | Pass? |
|-------|-------|-------|
| Empty | First-time user sees helpful guidance, not a blank screen | |
| Loading | Skeleton or spinner matches final layout shape | |
| Error | User knows what failed AND how to recover | |
| Partial | Mixed loaded/pending content is visually coherent | |
| Success | Confirmation is visible without being disruptive | |
| Offline | Graceful degradation or clear "offline" indicator | |

## Onboarding

- [ ] First-run experience guides without blocking
- [ ] Progressive disclosure: advanced features hidden until needed
- [ ] Empty states include a clear primary action ("Create your first...")
- [ ] No dead-end screens (every state has a next action)

## Error States

- [ ] Error messages are specific (not "Something went wrong")
- [ ] Recovery action is available (retry, go back, contact support)
- [ ] Form errors appear inline, not only as toast/alert
- [ ] Network errors distinguish timeout from server error

## Loading States

- [ ] Skeleton loaders match actual content layout
- [ ] No layout shift when content loads
- [ ] Long operations show progress (determinate > indeterminate)
- [ ] Optimistic UI used where safe (toggling, starring, archiving)

## Interaction Feedback

- [ ] Every clickable element has hover + active states
- [ ] Destructive actions require confirmation
- [ ] Undo available for reversible actions
- [ ] Focus states visible for keyboard navigation

## Responsive Verification

- [ ] Test at 390px (mobile), 768px (tablet), 1440px (desktop)
- [ ] No horizontal scroll at any viewport
- [ ] Touch targets ≥ 44px on mobile
- [ ] Navigation is accessible at all breakpoints

## Typography

- [ ] Headings render balanced (no orphaned single word)
- [ ] Body text max-width ≤ 65ch
- [ ] Line height comfortable for body (1.5-1.7) and headings (1.1-1.3)
- [ ] CJK text uses `word-break: keep-all` where appropriate

## Accessibility Minimum

- [ ] All images have meaningful `alt` text (or `alt=""` for decorative)
- [ ] Text contrast passes WCAG 1.4.3 (4.5:1 text, 3:1 large text); full AA statements follow dev-frontend [WCAG 2.2 AA](../../dev-frontend/references/core/wcag22-aa.md)
- [ ] Skip-to-content link present
- [ ] Forms have associated labels

## Experience Audit (when one was run)

- [ ] Every S1 gap in the [experience audit](experience-audit.md) gap ledger is verified fixed, or carries a wontfix decided by the user or product owner (never the agent) and is listed as open
- [ ] Each ideal-state statement this delivery touches has its verifier evidence attached
brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation).Stars: 322kUpdated Claude CodeCodexVerifiedInstall
brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).Stars: 198kUpdated Claude CodeCodexVerifiedInstall