SkillsBot.org

better-ui Skill

better-ui is Jakub Krehel's skill for the visual polish of an interface: surfaces, icons and motion. It gives Claude exact values, such as a 0.96 press scale over 150ms, instead of letting it guess.

  • License MIT
  • Installs 48K
  • GitHub stars 12.2K
  • Audits 3 of 3 passed

Our hands-on test, by SkillsBot.org

We asked Claude to polish a set of pricing cards

The pricing cards came out looking much the same with and without better-ui: soft layered shadows, line icons, check marks, equal-height cards and an arrow on the buttons. The difference is in the CSS, where the skill's exact values show up: a press scale of 0.96 over 150ms, entrances staggered 100ms apart over 300ms, its cubic-bezier(0.2, 0, 0, 1) curve, a transparent border kept under the shadow for high-contrast mode, hover gated to devices with a real pointer, and a fade instead of no animation under reduced motion. Plain Claude made its own choices (0.97, a different curve) and turned animation off entirely for reduced motion.

  • InstallWorked2 s with the skills CLI
  • Picked up on its ownYesinvoked better-ui
  • Time1 min 14 s1 min 5 s without the skill
  • API cost$0.38$0.42 without the skill
  • Output check7 KB, 4 media queries, 0 external URLsWithout: 7 KB, 1 media queries, 1 external URLs

The task, word for word

Polish the UI of the pricing cards in pricing.html: surfaces, shadows, icons, hover and press states, and motion. Keep it a single file. Don't ask me questions; make reasonable choices and finish.

With the skill

Three pricing cards polished with the better-ui skill: line icons, check marks, outlined buttons with arrows

Without the skill

The same cards polished without the skill: a similar look with a tinted Pro card and a divider above the features
pricing.html at rest on desktop. Without the skill the Pro card gets a gradient and a solid icon tile; with it, the three cards stay closer to each other. Full size: with the skill, without.

With the skill

The cards stacked on a phone, made with the skill

Without the skill

The cards stacked on a phone, made without the skill
On a phone both versions wrap the cards into one column. Full size: with the skill, without.

With the skill

Claude's report with the skill, grouped into surfaces, icons, states, motion and small fixes

Without the skill

Claude's report without the skill, with the same groups
Claude's reports. Both say the hover, press and focus states were not tried in a live browser. Full size: with the skill, without.

What it actually did

  1. Invoked the better-ui skill unprompted and read its shadow, scale-on-press and reduced-motion recipes.
  2. Replaced the border-only cards with layered shadows and kept the Pro card's border because it marks the recommended plan.
  3. Replaced the hover keyframe animation, which the skill says cannot reverse, with transitions.
  4. Took headless Chrome screenshots, then fixed the card heights and list alignment it saw in them.
  5. Gave buttons 2px less padding on the arrow side, the skill's optical-alignment rule.

Where it helped

  • Follows exact, repeatable values, so several pages polished with the skill will match each other.
  • Accessibility details plain Claude skipped: an edge in Windows high-contrast mode and a fade instead of a jump under reduced motion.
  • Hover effects do not get stuck on after a tap on a phone.

Limits we hit

  • At a glance the result is no better than plain Claude's, which also replaced the stuck animation and added focus outlines.
  • Neither run tested the hover, press or entrance motion in a real browser.
  • The skill hands typography, accessibility, layout and colour to other skills from the same author (better-typography and others), which we did not install.

Use it for

  • Design systems and component libraries where the same press, shadow and motion values should apply everywhere.
  • Polishing an interface that already works, not fixing a broken one; the skill says interaction problems come first.
  • Install the companion better-* skills if you want the full set of rules.

One run with the skill and one without, same prompt, fresh folders, Claude Code 2.1.326 in headless mode. How we test skills. Every skill we have tested.

Last updated . The better-ui skill is made and maintained by Jakub Krehel; SkillsBot.org is an independent directory and is not affiliated with it.

Use better-ui in Codex, Cursor and GitHub Copilot

better-ui is a standard Agent Skills folder, so the same files work in other coding agents. Name the agent when you install:

Parts of a skill that rely on Claude Code features, such as subagents or / commands, may behave differently elsewhere. Paths for each agent are in our install guide.

better-ui Skill facts

Author
Jakub Krehel (@jakubkrehel)
Repository
jakubkrehel/skills
License
MIT
Installs
48K
GitHub stars
12.2K
First seen on skills.sh
Jul 10, 2026
SKILL.md length
1,634 words
Other files
7

Security audits on skills.sh:

Installs, stars, first-seen date and audits from skills.sh on November 16, 2026. SKILL.md read from GitHub the same day.

What the better-ui skill does

The skill applies once the interaction already works; a polish fix never outranks a broken interaction. Its values are exact, not ranges, except optical nudges, which are judged by eye. It keeps the project's own component library and tokens, and treats a consistent house style (for example, no shadows) as a preference, not a problem.

Surfaces. Outer radius equals inner radius plus padding. Shadows show elevation and borders show structure. A transparent border stays under a shadow so Windows high-contrast mode still draws an edge. Content images get a faint 1px black or white outline.

Optical alignment. A button gets 2px less padding on its icon side, and odd glyphs are fixed in the SVG.

Motion. Interactive states use transitions, not keyframes, so they can reverse mid-way. Pressed buttons scale to 0.96 over 150ms, and disabled ones never scale. Frequent interactions respond in 150ms or less. One-time entrances are staggered 100ms apart. Exits are shorter than entrances. Movement runs only when the user has not asked for reduced motion; otherwise it becomes a fade.

Recipes live in separate files: animations, enter and exit, icon transitions, icons, performance and surfaces.

Related skills

better-ui hands typography, accessibility, layout and colour to its companion skills (better-typography, better-accessibility, better-layout and better-colors), all in the jakubkrehel/skills repository. See more design skills.

What is in the better-ui folder

  • SKILL.mdinstructions
  • animations.md
  • enter-exit.md
  • icon-transitions.md
  • icons.md
  • performance.md
  • surfaces.md
  • agents/1 file

better-ui Skill: FAQ

How do I install the better-ui skill?

Run npx skills add jakubkrehel/skills --skill better-ui, or leave out --skill to choose from the whole collection.

Will better-ui change my design system?

It is told to keep your component library, tokens and density, and to match your motion style wherever it gives no value of its own.

Is better-ui free?

Yes. It is open source under the MIT license.