Skip to content
SkillModel-led1,217 tokens in use

Better UI

Polishes surfaces and icons with exact values for border radius, optical alignment, shadows, image outlines, hover behavior and icon stroke and states.

12,497 stars on the repository MIT Licensejakubkrehel/skills · skills/better-ui
npx skills add jakubkrehel/skills
View source

Install command as written in the repository's README

Skill label

measured from its files

What installing Better UI costs

23tokens idle
1,217tokens in use
3,507tokens, up to

Idle is what sits in context while the skill is installed. In use is its instructions, loaded when it runs. Up to adds the files its instructions link. Counts are approximate, made offline with cl100k_base.

Model dependence Model-led

Script-ledMixedModel-led

Mostly instructions, so how well it works depends on the model that follows them.

This describes the skill's structure, how much of it is scripts. It does not say how well it works.

Touches

Nothing detected: no shell, network, file writes, git or credentials in its files.

Declared tags come from the skill's frontmatter; detected ones from its scripts, its code blocks and the commands it names in inline code. This is detected, not audited.

How it scores

Quality

How well the skill is written, counted from its own files: its frontmatter, its steps, examples, stated output and constraints, its size and whether every file it ships is one it names.How we score it →
Fair
  • Frontmatter8/15
  • Structure5/25
  • Examples0/15
  • Output10/15
  • Size15/15
  • Resources11/15

Security

Starts at 100 and loses points for each thing in the skill's files that a reader should look at first.How we score it →
Excellent

No findings.

Repository health

Pre-computed score based on development activity, maintenance, community, maturity, and trend momentum.How we score it →
Good
  • Development activity96
  • Maintenance52
  • Community48
  • Maturity24
  • Momentum40

Better UI is an agent skill that holds the visual polish for surfaces and icons, with the exact value each detail takes. It applies after the underlying interaction is sound, and a polish finding never outranks a broken interaction.

It keeps the project’s component library, tokens and density, treating a consistent house style such as no shadows as a preference. The same detail done two ways inside one project is a finding.

What You Get

  • Concentric radius rules and optical alignment nudges such as 2px less padding on the icon side of a button
  • Shadow recipes that replace depth-only borders, with a transparent border kept under a shadow ring for forced-colors mode
  • Image outline values in oklch black and white, with a note on why palette near-blacks leave a colored fringe
  • Icon rules: currentColor SVGs, stroke from 1.5px at weight 400 to 2.5px at weight 700, outline default and fill for active, and RTL mirroring only where meaning follows direction
  • A detection table covering matching radii on padded parents, hex fills in icons and unguarded hover styles

Common Use Cases

  • Fixing nested cards whose inner and outer corners look mismatched
  • Replacing a bordered card style with layered shadows while keeping forced-colors edges
  • Stopping hover styles from sticking after a tap on touch devices
  • Matching icon stroke to the text beside it across a toolbar

What Makes It Unique

Its values are exact, not ranges to approximate: an outline at 0.1 alpha is not one at 0.15, and a 1.5px stroke is not 2px. Only the optical nudges and the concentric padding cutoff are judged by eye. It also gives every adjacent topic, from hit areas to transitions, to a named sibling skill.

Under The Hood

The skill is a SKILL.md with three reference files for icons, surfaces and reporting. It has no scripts. The agent reads your components and styles, checks each defined state such as hover, pressed, selected, loading and empty from code, and with a browser walks each state in both themes. A review leaves files untouched, and edits happen when you ask for fixes.

Join founders building with open source

Opinionated takes, migration guides, cost-saving tips, and insights from the open source ecosystem.

Subscribe on SubstackJoin 750+ subscribers