make-interfaces-feel-better

Reviews and improves UI code across typography, surfaces, animations, icons, and performance.

Updated May 5, 2026
One-click install
npx skills add https://github.com/josippapez/ai-setup --skill make-interfaces-feel-better-josippapez
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: make-interfaces-feel-better
Source: https://github.com/josippapez/ai-setup/tree/main/claude/plugins/better-design/skills/make-interfaces-feel-better
Command: npx skills add https://github.com/josippapez/ai-setup --skill make-interfaces-feel-better-josippapez

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Interfaces often feel subtly off due to small compounding details like mismatched border radii, jarring animations, or misaligned icons. This Skill provides a systematic checklist of design engineering principles to identify and fix those polish issues in frontend code. ## Core Features & Use Cases - Structured UI Reviews: Run quick or full review modes that produce severity-rated findings tables with before/after code, covering typography, surfaces, animations, icons, and performance. - Concrete Fix Patterns: Apply exact, opinionated values for common polish work such as concentric border radius, scale-on-press at 0.96, tabular numbers, image outlines, and contextual icon cross-fades. - Framework-Aware Guidance: Adapts fixes to the project's existing styling system (Tailwind, plain CSS, CSS-in-JS) and motion library (motion, framer-motion, or CSS-only), never introducing new dependencies. - Use Case: A developer finishes a settings page and asks for a polish review; the Skill inspects hover states, nested card radii, and number rendering, then returns a findings table with actionable replacements. ## Quick Start Review my frontend components for interface polish issues and suggest fixes following the design detail principles.

Frequently Asked Questions about make-interfaces-feel-better

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: the outer radius must equal the inner radius plus the padding between them. For example, a card with 8px padding and a 12px inner radius needs a 20px outer radius. Equal radii on nested elements is the most common cause of interfaces feeling off.

How to animate icon changes on hover or state change?

Animate icons with opacity, scale, and blur instead of toggling visibility: scale from 0.25 to 1, opacity 0 to 1, blur 4px to 0px. With motion or framer-motion use a spring with duration 0.3 and bounce 0; without a library, keep both icons in the DOM and cross-fade with CSS transitions.

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

Use CSS transitions for interactive state changes because they are interruptible and retarget mid-animation when the user changes intent. Reserve keyframe animations for staged one-shot sequences like enter animations or loading states.

Does this work with Tailwind and framer-motion projects?

Yes, the guidance adapts to the project's existing stack: Tailwind classes in Tailwind projects, plain CSS otherwise, and imports from motion or framer-motion matching what package.json already contains. It never introduces a second styling system or new dependency.

Why should I avoid transition: all in CSS?

transition: all forces the browser to watch every property, causing unintended animations on colors, padding, or shadows and blocking optimizations. Always name exact properties, such as transition-property: scale, opacity, or use Tailwind's transition-transform for transform-only changes.

When should I not add animations to an interface?

Skip custom animation on high-frequency interactions like row hovers or keystrokes; use instant feedback or a minimal opacity or color transition under 150ms instead. Motion must never be the only feedback channel, and reduced-motion preferences should be honored.