Tooluck logoTooluck
SKILL.md

improve-ui

Agent skill fromibelick/ui-skills

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.

How to install improve-ui

install improve-ui
# install the ui-skills pack with the skills CLI
npx skills add ibelick/ui-skills

# or add only this skill to Claude Code: copy the folder

skills/improve-ui/

# into

~/.claude/skills/improve-ui/ (all projects)

.claude/skills/improve-ui/ (one project)

skills/improve-ui/SKILL.md

MITFull file
1# Improve UI
2
3Audit 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.
4
5## Boundaries
6
7- Never modify product source. Create or edit files only under `design-plans/`.
8- Do not install dependencies, run formatters, commit, push, or otherwise mutate the working tree.
9- Do not update design documentation. Record accepted documentation changes in the plan for its executor.
10- Use rendered evidence only when the user provides it or explicitly requests visual inspection.
11- Make every plan self-contained; its executor has no context from the audit or conversation.
12
13## 1. Select the surface
14
15Honor the user's scope. If the request is broad, select one deployable application and one coherent surface family representing a primary product task. State the selection; do not synthesize the whole repository into one product.
16
17Start from the surface's routes and layouts. Trace the rendered path through compositions, shared components, variants, resolved tokens, and styles. Do not begin with a repository-wide search for inconsistencies.
18…

Excerpt shown under the repository's MIT license.

More skills in ui-skills

Keep exploring

Similar skill repositories

Newsletter

Join the Community

Subscribe to our newsletter for the latest news and updates