SKILL

better-ui

Applies exact UI polish values: concentric border radius, optical alignment, layered surface shadows, neutral image outlines, a 0.96 press scale, icon cross-fades, and theme-switch transition suppression. Activates when editing component CSS or Tailwind, when an interface looks slightly off, or when the user says 'polish the UI', 'better UI', 'concentric radius', 'optical alignment', 'shadow instead of border', or 'icon transition'. Do not use for design-system choice, accessibility audits, or building the page - that is vd:uiuxdesign. Do not use for posting a PR review - that is vd:code-review.

Target: Design & content creation. Automatically collected · unverified.

Excerpt from the author’s documentation

Extracted from a fixed version of SKILL.md in its original language. This is the author’s documentation; installation, compatibility and runtime results have not been verified by this site.

Read the original English text

Topics in the source

  • UI polish
  • Concentric border radius
  • Optical over geometric alignment
  • Shadows for elevation, borders for structure
  • Interruptible animations
  • Split and stagger enter animations
  • Subtle exit animations
  • Contextual icon animations

Exact values for the small details that make an interface feel finished. Ported from jakubkrehel/skills better-ui (MIT). Use the numbers written here. When reviewing, slow the interface down. What feels off at 10% speed is what is subtly wrong at full speed. Keep the project's component library, tokens, and density, and match its motion language except where a rule below prescribes an exact interaction. Every duration, curve, scale, and blur below is a specific value, not a range to approximate. cubic-bezier(0.2, 0, 0, 1) is not cubic-bezier(0.4, 0, 0.2, 1), and 0.96 is not 0.95. Use what is written. Text wrapping, font rendering, tabular numbers, spacing, breakpoints, hit areas, focus, keyboard support, ARIA, and reduced motion belong to vd:uiuxdesign. Whether a motion should exist, which easing family to use, and how popovers, drawers, and drags behave belong to vd:design-eng. Posting review comments on a pull request belongs to vd:code-review. This skill owns the polish values and the polish-pass report. When both load, the numbers in this file win. Outer radius = inner radius + padding. Mismatched radii on nested elements is the most common thing that makes an interface feel of

This is an excerpt. Refer to the complete source and its current requirements.

Source repository
vanducng/skills
Source file
skills/better-ui/SKILL.md
Fixed revision
c20411b8df8f821988c87689f6aefe142b6f9025
Read the complete original documentation ↗

Sources and evidence

This record was collected automatically. Its documentation, suitability and runtime behavior have not been manually verified.

Author: vanducng/skills · original repository metadata. Documentation review: Not reviewed. Last source check: 2026-11-11T14:02:27.183Z.

Categories are inferred from names, descriptions and paths. They do not establish compatibility.

License and attribution

MIT. Third-party content and copyright remain with their authors. Refer to the original license and terms.

Original license ↗

Synchronization, copying and user-reported success do not mark a resource as runtime-tested.

Limitations and notes

  • Collecting metadata does not mean this site has installed, adapted, runtime-tested or security-reviewed the resource.