make-interfaces-feel-better

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

2|Updated Aug 26, 2025
One-click install
npx skills add https://github.com/omergulcicek/takvim --skill make-interfaces-feel-better-omergulcicek
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: make-interfaces-feel-better
Source: https://github.com/omergulcicek/takvim/tree/main/web/.agents/skills/make-interfaces-feel-better
Command: npx skills add https://github.com/omergulcicek/takvim --skill make-interfaces-feel-better-omergulcicek

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 set of design engineering principles to identify and fix those polish issues in frontend code. ## Core Features & Use Cases - Design Principle Checklist: 19 concrete principles covering concentric border radius, optical alignment, shadow-based elevation, interruptible animations, tabular numbers, hit areas, and icon stroke weights. - Structured Review Modes: Quick mode for high-traffic paths (HIGH/MEDIUM findings, cap of 5) and full mode for comprehensive audits (cap of 15), with severity-rated findings tables showing before/after code. - 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 fallbacks). - Use Case: When a button press feels unresponsive or a card layout looks off, run a review to get specific findings like adding active:scale-[0.96] or correcting nested border radii with exact file and line references. ## Quick Start Review my UI components for polish issues and suggest fixes following interface design 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 my UI feel more polished?

Apply small compounding details: use concentric border radii on nested elements, replace elevation borders with layered box-shadows, add subtle scale(0.96) press feedback on buttons, and use tabular-nums for dynamic numbers. Review motion at 10% speed to catch subtle issues.

How to animate icon state changes in React?

Animate icons with opacity, scale (0.25 to 1), and blur (4px to 0px) instead of toggling visibility. Use motion or framer-motion with a spring transition (duration 0.3, bounce 0) if installed, otherwise cross-fade both icons in the DOM with CSS transitions.

Should I use CSS transitions or keyframe animations?

Use CSS transitions for interactive state changes like hover, toggle, and open/close because they are interruptible mid-animation. Reserve keyframe animations for staged one-shot sequences like enter animations or loading states.

Does this work with Tailwind CSS projects?

Yes, all principles include Tailwind-specific examples such as active:scale-[0.96], tabular-nums, text-balance, and transition-transform. The Skill adapts fixes to whatever styling system the project already uses without introducing a second one.

Why should I avoid transition: all in CSS?

transition: all forces the browser to watch every property, causes unintended animations on properties like padding or colors, and blocks browser optimizations. Always specify exact properties such as transition-property: scale, opacity.

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/color transition under 150ms. Motion must never be the only feedback channel, and reduced-motion preferences should be honored.