improve-ui
Audit an existing product surface against its own design evidence, identify verified UI problems, and write self-contained implementation plans for another agent. Strictly read-only on product source. Use when asked to review, refine, improve, or clean up an interface without replacing its identity; investigate design-system drift; or prepare a design handoff.
Before you install
- Last update
- Files in folder
- 3
- Scripts
- No script files found
- SKILL.md size
- 7.6 KB (about 1,958 tokens of context each time it loads)
- License
- MIT
- Source on GitHub
- ibelick/ui-skills
Skills are plain text instructions the agent follows, sometimes with scripts. Check the source, prefer repositories with many installs and stars, and read any script it ships.
Install
npx skills add ibelick/ui-skills@improve-uiRuns in a terminal with Node.js 18 or newer. Add -y to skip the prompts and -g to install for every project instead of this one.
Install for your agent
npx skills add ibelick/ui-skills@improve-ui --agent claude-code -y- Project install writes to
.claude/skills/improve-ui- Global install writes to
~/.claude/skills/improve-ui
Start a new session afterwards so the agent picks the skill up. In Claude Code you can also call it directly with /improve-ui.
What it does
Improve UI Audit one coherent product surface against the system that actually governs it. Preserve the product's identity, reuse existing owners, and prefer no finding to an unsupported one. Write plans only for changes the user selects; another agent executes them. Boundaries - Never modify product source. Create or edit files only under design-plans/. - Do not install dependencies, run formatters, commit, push, or otherwise mutate the working tree. - Do not update design documentation. Record accepted documentation changes in the plan for its executor. - Use rendered evidence only when the…
Excerpt from the skill's own SKILL.md. Read the full file on GitHub before installing: skills run with your agent's permissions.
Categories
Related skills
- fixing-motion-performance
ibelick/ui-skills
Audit and fix animation performance issues including layout thrashing, compositor properties, scroll-linked motion, and blur effects. Use when animations stutter, transitions jank, or reviewing CSS/JS animation performance.
- baseline-ui
ibelick/ui-skills
Quickly deslop UI code by fixing spacing, hierarchy, typography, and small layout issues. Use when the interface needs a fast cleanup or polish pass.
- fixing-accessibility
ibelick/ui-skills
Audit and fix HTML accessibility issues including ARIA labels, keyboard navigation, focus management, color contrast, and form errors. Use when adding interactive controls, forms, dialogs, or reviewing WCAG compliance.
- fixing-metadata
ibelick/ui-skills
Audit and fix HTML metadata including page titles, meta descriptions, canonical URLs, Open Graph tags, Twitter cards, favicons, JSON-LD structured data, and robots directives. Use when adding SEO metadata, fixing social share previews, reviewing Open Graph tags, setting up canonical URLs, or shipping new pages that need correct meta tags.
- ui-skills-root
ibelick/ui-skills
Use before UI-related work to select the smallest useful UI Skills context through the ui-skills CLI.
- create-design-md
ibelick/ui-skills
Create or update a DESIGN.md from an existing product repository or public website. Use when asked to document an interface's design language, reconstruct its visual system, extract design tokens and guidance from current evidence, or give coding agents persistent UI context. Do not modify product source or promote accidental implementation patterns into design decisions.