ui-design-review
Skill4 starsChanged 2 months agoApache-2.0View on GitHub
Design, polish, or critique a product UI with deliberate hierarchy, typography, layout, states, and responsive behavior. Explicit design pass; preserve established product tokens unless change is requested.
3 other projects use a version of this.
Adopted by
Most recently taken up by
- mastepanoski/claude-skillstheir own version, first seen Oct 13, 2026
- jayminwest/warrentheir own version, first seen Oct 13, 2026
- kennyolofsson23-netizen/claude-code-configtheir own version, first seen Mar 16, 2026
Other versions3 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 3
- jayminwest/warren★ 519same name
- mastepanoski/claude-skills★ 62same name
- kennyolofsson23-netizen/claude-code-config★ 0same name
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository81 other files it gives its agents.
- agent-cli-designSkill
- agent-tool-boundariesSkill
- behavior-first-implementationSkill
- bounded-prototypeSkill
- bounded-pr-sliceSkill
- building-fdd-validationSkill
- context-efficiencySkill
- cross-language-contractsSkill
- cross-platform-agent-instructionsSkill
- design-interviewSkill
- diagnosis-loopSkill
- domain-languageSkill
- edge-cloud-syncSkill
- handoff-continuitySkill
- immutable-pr-reviewSkill
- memory-context-hygieneSkill
- module-designSkill
- orchestrateSkill
- owner-decision-gateSkill
- parallel-portfolioSkill
- pr-gate-loopSkill
- pyo3-async-lifecycleSkill
- pyo3-buffer-performanceSkill
- pyo3-free-threadingSkill
- pyo3-ownership-errorsSkill
- pyo3-wheel-releaseSkill
- python-api-typingSkill
- python-async-concurrencySkill
- python-ci-releaseSkill
- python-data-boundariesSkill
- python-packaging-environmentsSkill
- python-performanceSkill
- python-pytestSkill
- python-reviewSkill
- python-test-designSkill
- python-threading-workersSkill
- python-workflowSkill
- react-components-stateSkill
- react-performanceSkill
- repository-groundingSkill
- rust-api-designSkill
- rust-async-concurrencySkill
- rust-build-diagnosticsSkill
- rust-ci-releaseSkill
- rust-memory-layoutSkill
- rust-nextestSkill
- rust-numerics-simdSkill
- rust-performanceSkill
- rust-protocol-codecsSkill
- rust-python-bindingsSkill
- rust-reviewSkill
- rust-storage-durabilitySkill
- rust-test-designSkill
- rust-unsafe-ffiSkill
- rust-workflowSkill
- rust-workspace-dependenciesSkill
- shadcn-react-componentsSkill
- shadcn-svelte-componentsSkill
- simplify-existing-codeSkill
- source-verificationSkill
- The first 60 shown.
The file
We split this skill into the rules it gives an agent
3 rules. 0 are common, 3 are distinctive, and 0 are very specific to this project.
0
Common
Most of the 3 edited versions we read keep these.
3
Distinctive
This author's own choices. Worth a look.
0
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 10
Read the brief, existing screen, shared tokens, neighboring components, and real content shape.
- Distinctive: line 26
Use spacing and type to establish hierarchy.
- Distinctive: line 50
Read practice notes and sources only when the task needs more depth.
“Common” is measured: kept by at least 6 in 10 of the 3 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
UI Design and Visual Review
Ground the screen in its job
Read the brief, existing screen, shared tokens, neighboring components, and real content shape. Determine what the operator needs to notice, understand, and do next. For an existing product, visual consistency and clarity usually matter more than inventing a new identity. Do not turn a workbench into a landing-page hero because a design skill prioritizes novelty.
For genuinely new visual direction, make a compact choice about hierarchy, density, typography, and palette, then implement it. Do not create a separate design system document or mandatory planning artifact unless requested. Respect explicit user aesthetics over generic preferences.
Design all meaningful states
Work with realistic long names, counts, timestamps, units, and permission states. Include loading, empty, error, unavailable, stale, selected, disabled, and pending outcomes as applicable. Use concise action labels and specific recoverable errors. Do not invent business metrics or customer evidence to make a mock screen look populated; label illustrative data clearly.
Use spacing and type to establish hierarchy. Reserve emphasis for the primary task and meaningful status. Avoid decorating every datum as a card, hiding important controls in tooltips, or using color alone for operational meaning. Motion should explain a transition, respect reduced motion, and not compete with live data.
Walk through a real task
Choose a representative task with a clear start and observable finish. Check whether the user can find the next action, understand the consequence, recognize completion, and recover from one realistic error without losing useful work. Repeated backtracking, hidden prerequisites, and unclear outcomes matter more than cosmetic novelty.
Keep inspection findings separate from usability evidence. A source or browser walkthrough can suggest a problem; it does not prove a measured improvement in task success or speed. Use realistic localized content and narrow layouts when those are supported, rather than evaluating only ideal short English labels.
Implement, inspect, refine
Reuse framework-specific shadcn/local components. Inspect the rendered result when browser tools are available: desktop and narrow view, both supported themes, long content, open overlays, and failure states. Check alignment, overflow, contrast, focus visibility, and text hierarchy. A screenshot alone does not prove interaction behavior.
Make a focused refinement pass and explain only consequential design decisions. Without a rendered browser, report a source-level design review and leave visual validation explicitly unrun. Do not claim pixel-perfect output or accessibility conformance from code inspection.
Further guidance
Read practice notes and sources only when the task needs more depth.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

