ui-redesign
Skill0 starsChanged 3 months agoApache-2.0View on GitHub
Redesign an existing website page into a polished, professional, human-designed interface that does not look AI-generated — while preserving all existing functionality. Works across React, Next.js, plain HTML/CSS/JS, Django templates, and similar web projects. Use when the user asks to redesign, restyle, revamp, modernize, clean up, or improve the look of an existing page or UI.
3 other projects use a version of this.
Adopted by
Most recently taken up by
- Achref23illi/ui-redesigntheir own version, first seen Nov 8, 2026
- rashee1997/ui-redesigntheir own version, first seen Oct 17, 2026
- FL45h-09/claude-skillstheir own version, first seen Aug 30, 2026
Other versions3 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 3
- Achref23illi/ui-redesign★ 3same name
- rashee1997/ui-redesign★ 2same name
- FL45h-09/claude-skills★ 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 repository49 other files it gives its agents.
- accessibility-auditorSkill
- api-doctorSkill
- browser-compatibilitySkill
- build-doctorSkill
- bundle-doctorSkill
- cache-doctorSkill
- change-cartographerSkill
- ci-cd-doctorSkill
- code-auditorSkill
- code-migratorSkill
- code-reviewerSkill
- config-doctorSkill
- container-doctorSkill
- context-keeperSkill
- contract-testerSkill
- cron-doctorSkill
- database-doctorSkill
- decision-memorySkill
- dependency-doctorSkill
- documentation-engineerSkill
- env-guardSkill
- error-boundary-doctorSkill
- feature-integritySkill
- git-hygieneSkill
- handoff-engineerSkill
- i18n-auditorSkill
- incident-debuggerSkill
- intent-architectSkill
- log-doctorSkill
- motion-designerSkill
- observability-engineerSkill
- performance-optimizerSkill
- product-architectSkill
- project-driftSkill
- qa-engineerSkill
- refactor-engineerSkill
- release-notesSkill
- runtime-doctorSkill
- safe-scopeSkill
- security-auditorSkill
- seo-doctorSkill
- ship-itSkill
- skill-managerSkill
- spec-doctorSkill
- state-managerSkill
- terminal-visualizerSkill
- test-engineerSkill
- type-safety-auditorSkill
- ux-friction-hunterSkill
The file
We split this skill into the rules it gives an agent
7 rules. 0 are common, 5 are distinctive, and 2 are very specific to this project.
0
Common
Most of the 3 edited versions we read keep these.
5
Distinctive
This author's own choices. Worth a look.
2
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 12
Stay in scope: Only touch the current project.
- Distinctive: line 27
Do not edit yet.
- Very specific: line 68
Use subtle animation *only* where it aids usability or feedback (state changes, focus, meaningful transitions).
- Distinctive: line 81
Keep dependencies lean: Don't add UI libraries, icon packs, or font bundles unless clearly justified and lightweight.
- Distinctive: line 85
Start the dev server (or build) using the project's own commands.
- Very specific: line 86
Check for: build errors, console errors/warnings, broken imports or missing assets, layout at mobile/tablet/desktop breakpoints, …
- Distinctive: line 87
Fix every problem you find: before moving on. Re-run until clean.
“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 Redesign
Redesign an existing page so it looks like a competent human designer made deliberate choices — not like a template or an AI generator filled in defaults. The bar is not "modern"; the bar is "intentional." Two hard constraints govern everything below:
- Preserve behavior. The redesign is visual and structural-in-markup only. Functionality, data, and logic must work exactly as before.
- Stay in scope. Only touch the current project. Never modify unrelated projects or files outside the working directory.
Work through the phases in order. Do not skip inspection to jump to code.
Phase 1 — Inspect before changing anything
Understand what exists before altering a single line.
- Detect the stack and entry points. Look for
package.json,next.config.*,vite.config.*,index.html,manage.py/templates/, or static*.html/*.css. Identify the framework, styling approach (CSS/Sass, CSS Modules, Tailwind, styled-components, plain stylesheets), and component conventions already in use. - Locate the exact page(s) in scope and read them fully, plus the components, layouts, and stylesheets they pull in.
- Inventory existing design assets: fonts, color tokens/variables, logo, images/SVGs, spacing scales, shared components (buttons, inputs, cards, nav). You will reuse these where possible.
- Note the tooling: dev server command, build command, linting. You'll need these in Phase 6.
Do not edit yet.
Phase 2 — Understand purpose and content
- What is this page for? Who uses it, and what is the single most important thing they came to do?
- Map the real content hierarchy — what must be seen first, what is secondary, what is chrome.
- Catalog existing functionality that must survive untouched: routing, links, API calls, data fetching, authentication/authorization, form submission and validation, state management, event handlers, and business logic. Note every
id,class,data-*,name,htmlFor/for,aria-*, ref, and hook the code depends on. These are contracts — preserve the ones behavior relies on.
Phase 3 — Diagnose the current UI
List concrete, specific problems (not vague adjectives) in each area:
- Hierarchy — is the primary action/content actually dominant?
- Spacing — inconsistent gaps, cramped or arbitrary padding, no rhythm.
- Typography — too many sizes/weights, poor scale, weak line-height/measure, default system stack used thoughtlessly.
- Layout & alignment — nothing lines up to a grid, centered-everything, no structure.
- Responsiveness — breakpoints missing or broken; mobile is an afterthought.
- Consistency — buttons/inputs/colors differ across the page for no reason.
- Usability — unclear affordances, poor contrast, tiny tap targets, ambiguous states.
Phase 4 — Establish a design direction (before implementing)
Decide the direction first, then execute it. Define a small, coherent system:
- Type: a deliberate pairing (display + body, plus a utility/mono role if data-heavy) and a clear modular scale with intentional weights and line-heights. Prefer refining the existing typeface choices over adding new ones unless they're genuinely wrong.
- Color: a restrained palette — one or two real accents plus a neutral ramp. Reuse existing brand tokens/variables when they exist.
- Spacing & grid: one spacing scale (e.g. 4/8-based) and a grid or column structure that content aligns to.
- Layout concept: how the page is sectioned, where whitespace does the work, and where an asymmetric or editorial composition serves the content better than yet another centered stack.
Sanity-check the direction against the brief: if any part reads like the default you'd produce for any page, revise it and make it specific to this product's purpose and content.
Phase 5 — Implement the redesign
Actually build it — do not merely propose changes.
Preserve behavior while restyling. Change markup structure, classes, and styles freely, but keep the hooks logic depends on: routes and hrefs, API/fetch calls, auth gates, form name/validation/submit handlers, state bindings, event handlers, and the attributes/selectors they key off. When you restructure an element that carries a behavioral contract, carry the contract with it and verify the wiring still resolves.
Design principles — make it look human-made:
- Lead with strong typography, generous and consistent whitespace, real alignment to the grid, and clear visual hierarchy. Restrained color.
- Design each breakpoint intentionally — mobile, tablet, desktop are distinct compositions, not one layout that merely shrinks. Ensure adequate tap targets and readable measure on small screens.
- Use subtle animation only where it aids usability or feedback (state changes, focus, meaningful transitions). Respect
prefers-reduced-motion. - Reuse existing components and assets; extend rather than duplicate. Introduce a new component only when it genuinely doesn't exist.
Avoid the generic-AI aesthetic. Do not:
- Wrap every section in a card — most sections are better defined by whitespace, a heading, and alignment than by a bordered box.
- Lean on excessive glassmorphism, gradients, or blur.
- Over-round everything, scatter decorative blobs, or stack drop-shadows for depth that isn't there.
- Sprinkle icons on every item or animate things that don't need it.
- Reach for these defaults: cream-background + serif + terracotta; near-black + one acid accent; hairline-ruled "broadsheet" columns. Fine if the brief truly calls for one; not fine as an autopilot choice.
Prefer instead: intentional sectioning, dividers and rules used sparingly, typographic contrast, whitespace as structure, and asymmetric/editorial layouts where they fit the content.
Keep dependencies lean. Don't add UI libraries, icon packs, or font bundles unless clearly justified and lightweight. Don't rewrite working code that isn't part of the redesign.
Phase 6 — Run and test
- Start the dev server (or build) using the project's own commands. If a browser-automation/verify skill is available, use it to load the page and capture the rendered result and console output.
- Check for: build errors, console errors/warnings, broken imports or missing assets, layout at mobile/tablet/desktop breakpoints, accessibility (contrast, focus visibility, semantic markup, labels/alt, keyboard nav), and visual consistency across states.
- Fix every problem you find before moving on. Re-run until clean.
Phase 7 — Final visual review
Look at the result critically, as if reviewing someone else's work. Anything that still feels generic, templated, or AI-generated — a needless card, a default gradient, misaligned spacing, an unmotivated animation — refine or remove it. Confirm the two hard constraints held: behavior preserved, nothing outside the project touched.
Phase 8 — Report
Summarize concisely:
- What was redesigned — pages/sections addressed.
- Major design decisions — type, color, layout, spacing direction and the reasoning.
- Components changed / created — with file paths.
- Responsive improvements — what changed per breakpoint.
- Remaining issues — anything unresolved, deferred, or needing the user's input.
Guardrails, always: preserve existing functionality; keep the change visual/structural, not behavioral; reuse before adding; add no unnecessary dependencies; and never modify unrelated projects or files outside the current project.
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.

