# jakubkrehel/make-interfaces-feel-better

An agent skill that helps make your interface feel better.

Repository: https://github.com/jakubkrehel/make-interfaces-feel-better
Canonical: https://ross.abutalabs.com/products/make-interfaces-feel-better
Homepage: https://jakub.kr/writing/details-that-make-interfaces-feel-better
Language: Markdown
License: MIT
License Family: permissive
Last push: 2026-08-12T11:45:31+00:00

## Health v2 (maintenance only)
Score: 58/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 97, release rhythm 35, longevity 12
- inputs: {"age_days": 174, "days_push": 21, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases, young
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 3020, forks 123 (observed 2026-08-28T04:07:38.465840+00:00)

## What it is
An installable agent skill packaged as a Markdown instruction file that teaches AI coding agents the small interface details that make UIs feel better, such as animations, typography, text wrapping, hover states, optical alignment, concentric border radius, shadows, and hit areas. It is distributed through the skills.sh ecosystem and installed into compatible coding agents with 'npx skills add'.

## Use cases
- make my AI coding agent produce better looking UIs
- agent skill for frontend design polish
- teach an LLM agent about concentric border radius and optical alignment
- improve animations and typography in AI-generated interfaces
- fix hover states and hit areas in generated web UIs
- install a design-details skill for Claude or other coding agents

## When to choose
- you use AI coding agents and want their frontend output to follow proven UI polish details
- you want a lightweight, MIT-licensed Markdown skill instead of a full design system or component library
- your generated interfaces need refinement in animations, typography, spacing, shadows, and micro-interactions

## When to avoid
- you need actual runnable components, stylesheets, or code rather than design guidance for agents
- you do not use AI coding agents and just want a design reference to read yourself
- you need enforceable lint or CI checks instead of prompt-style instructions

## Facets
- artifact type: plugin
- maturity: active
- function: prompt-engineering, documentation
- domain: frontend, web-design, web-development, developer-tools
- platform: cross-platform, cli
- tags: agent-skills, skills-sh, ui-polish, design-details, animations, typography, hover-states, optical-alignment, border-radius, shadows, hit-areas, frontend-design, markdown-skill, ai-agents

## Member repositories
- jakubkrehel/make-interfaces-feel-better (main) score 58

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:07:38.465840+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T07:30:01.213799+00:00, confidence not recorded.
  - readme: https://github.com/jakubkrehel/make-interfaces-feel-better (fetched 2026-08-28T04:07:38.465840+00:00, sha ba1a9f85bc8f)
  - homepage: https://jakub.kr/writing/details-that-make-interfaces-feel-better (fetched 2026-08-29T09:45:03.819466+00:00, sha 332cdb7bd7f6)
- Data as of 2026-08-30T08:39:29.467469+00:00.