better-ui

Applies design engineering principles to polish UI components, animations, and visual details.

3|Updated Apr 20, 2026
One-click install
npx skills add https://github.com/langgenius/due-date-hq-jwl --skill better-ui-langgenius
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: better-ui
Source: https://github.com/langgenius/due-date-hq-jwl/tree/main/.claude/skills/better-ui
Command: npx skills add https://github.com/langgenius/due-date-hq-jwl --skill better-ui-langgenius

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Interfaces often feel off due to small compounding details like mismatched border radii, jarring animations, hard borders, and tiny hit areas. This Skill provides concrete, opinionated rules for reviewing and fixing those details in frontend code. ## Core Features & Use Cases - Surface Polish: Enforces concentric border radius, optical alignment, layered box-shadows instead of borders, and pure black/white image outlines. - Animation Standards: Guides interruptible CSS transitions, split-and-stagger enter animations, subtle exits, contextual icon cross-fades, and scale-on-press feedback. - Performance Guardrails: Bans transition: all, restricts will-change to GPU-compositable properties, and enforces minimum 44x44px hit areas. - Use Case: When a settings page feels unpolished, run a review to get a Before/After table of fixes such as correcting nested radii, adding staggered enter animations, and replacing card borders with layered shadows. ## Quick Start Review my UI component code and suggest polish improvements for animations, shadows, and border radius.

Frequently Asked Questions about better-ui

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

FAQPage Schema
How do I make nested border radius look right in CSS?

Use concentric border radius: outer radius equals inner radius plus padding. For example, a card with 8px padding and a 12px inner radius needs a 20px outer radius. If padding exceeds 24px, treat layers as separate surfaces instead.

How to animate icon changes without Framer Motion?

Keep both icons in the DOM with one absolutely positioned over the other, then cross-fade using CSS transitions on opacity, scale (0.25 to 1), and blur (4px to 0) with cubic-bezier(0.2, 0, 0, 1). Since neither icon unmounts, both enter and exit animate smoothly.

Should I use box-shadow or border for card depth?

Use layered box-shadows for cards, buttons, and elevated elements because transparent shadows adapt to any background. Keep borders for dividers, table boundaries, and form input outlines where layout separation is the goal.

Why does transition: all cause animation problems?

transition: all forces the browser to watch every property, causing unintended animations on colors, padding, or shadows and blocking optimizations. Always list exact properties like transition-property: scale, opacity instead.

When should I use will-change in CSS animations?

Use will-change only for transform, opacity, or filter when you notice first-frame stutter, especially in Safari. Never use will-change: all or apply it preemptively, since each compositing layer costs memory.

What is the minimum hit area for buttons on mobile?

Interactive elements need a 44x44px hit area for touch or mobile contexts, and at least 40x40px in desktop interfaces. Extend smaller visible elements with a centered pseudo-element, and never let two hit areas overlap.