better-ui

Reviews and improves UI code for border radius, alignment, shadows, icons, and animation details.

6.7k|239|Updated Jul 10, 2026
One-click install
npx skills add https://github.com/jakubkrehel/skills --skill better-ui-jakubkrehel
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: better-ui
Source: https://github.com/jakubkrehel/skills/tree/main/skills/better-ui
Command: npx skills add https://github.com/jakubkrehel/skills --skill better-ui-jakubkrehel

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Interfaces often feel subtly off because of small compounding details: mismatched nested border radii, geometrically centered icons that look unbalanced, borders used where shadows belong, and animations that stutter or smear. This Skill gives an AI agent a concrete rulebook of exact values and recipes to audit and fix those UI polish issues in your project. ## Core Features & Use Cases - Surface and radius rules: Enforces concentric border radius (outer = inner + padding), layered box-shadow recipes for light and dark mode, and pure black/white image outlines instead of tinted ones. - Animation recipes: Provides exact values for interruptible CSS transitions, scale-on-press feedback (0.96), staggered enter animations, subtle exits, contextual icon cross-fades, and suppressing transitions during theme switches. - Icon consistency: Matches icon stroke width to adjacent text weight, uses one SVG recolored per state via currentColor, pairs outline/fill variants with state, and handles RTL flipping. - Use Case: Ask the agent to review a card component, and it reports findings in a severity-ranked table (HIGH/MEDIUM/LOW) with file locations, before/after values, and a final Block or Approve verdict. ## Quick Start Ask the agent to review the UI polish of a component or page in your project, covering border radius, shadows, icons, and animations, and report findings by severity.

Frequently Asked Questions about better-ui

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

FAQPage Schema
How do I fix mismatched border radius on nested elements?▼

Apply the concentric radius rule: outer radius equals inner radius plus the padding between them. For example, a card with 8px padding and a 12px inner radius needs a 20px outer radius. Past 24px of padding, treat layers as separate surfaces.

How do I animate icon changes with Framer Motion?▼

Use AnimatePresence with a keyed motion element, animating opacity 0 to 1, scale 0.25 to 1, and blur 4px to 0px with transition type spring, duration 0.3, and bounce 0. Import from motion/react or framer-motion matching the installed package.

Should I use CSS transitions or keyframe animations for interactive elements?▼

Use CSS transitions for interactive state changes like hover, toggle, and open/close because they can be interrupted and retargeted mid-animation. Reserve keyframes for one-shot staged sequences such as enter animations and loading states.

Why does my theme toggle animate the whole page?▼

A theme flip changes color, background, border, and shadow on every element at once, so all transitions fire together and smear. Inject a stylesheet disabling all transitions, force a reflow, then remove it on the next frame.

When should I use will-change in CSS animations?▼

Add will-change only for transform, opacity, and filter, which the GPU can composite, and only when you observe first-frame stutter. Never use will-change: all or apply it preemptively, since each compositing layer costs memory.

What icon stroke width should I use next to text?▼

Match the stroke to the adjacent text weight: 1.5px beside regular 400 weight text, 2px beside semibold 600, and 2.5px beside bold 700. Keep one stroke convention per surface and one icon library per toolbar.