interface-redesign
Upgrades an existing interface to a higher standard without rebuilding it — auditing what is there, identifying what reads as generic or unfinished, and sequencing changes by impact. Use this when a product works but looks dated or default, when a redesign is being considered, wh
Install
npx skills add https://github.com/cbrock84/headcount/tree/main/plugins/product/skills/interface-redesign
claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install cbrock84-headcount@llmmart
git clone https://github.com/cbrock84/headcount.git
The skills CLI installs just this skill, for any of its supported agents. Claude Code installs the whole cbrock84/headcount collection as a plugin from our marketplace. Git is the plain clone.
Skill manifest
Interface redesign
Most interfaces do not need rebuilding. They need a dozen specific things fixed, in the right order.
Audit first
Go through the real product, on a real device, doing a real task. Record what you find in these categories — the order is the priority order:
- Structural — unclear primary action, competing focal points, navigation that does not match the mental model. These are the only ones worth a rebuild.
- Systemic — inconsistent spacing, more type sizes than a scale would allow, palette drift, components that exist in variants. High impact, mechanical to fix.
- Craft — weak hierarchy, poor contrast, unfinished states, cramped density.
- Cosmetic — dated shadows, default border radii, stock illustration.
The generic-AI-product tells
These are the specific things that make a product read as unconsidered. They are worth naming because they are all cheap to fix:
- Default framework styling left in place — the untouched button, the starter-template card.
- One accent color used for every emphasis, so nothing is emphasized.
- Uniform spacing everywhere, so nothing groups.
- Centered everything, including body copy.
- Emoji standing in for iconography.
- Gradients on surfaces that carry no meaning.
- Empty and error states that were never designed.
Sequencing
Fix in this order, because each makes the next easier to see:
- Tokens — spacing scale, type scale, palette. This alone resolves most systemic findings.
- Hierarchy on the two or three highest-traffic screens.
- States: empty, loading, error, overflow.
- Component consolidation.
- Cosmetic pass.
Restyle or rebuild
Rebuild only when the structure is wrong — when the information architecture does not match how people work. Everything else is a restyle, and a restyle that ships beats a rebuild that stalls.
Sources
references/sources.md in this skill lists the outside authorities that settle the questions
here — what each one is authoritative for, and what you may do with it. Check them before
answering on anything they cover, and cite what you used. Most are free to read and not free
to reproduce; the use note on each is binding.
Never
- Restyle a screen whose problem is structural. New paint on a broken flow buys nothing.
- Change navigation and visual language in the same release. When something breaks you will not know which one did it.
- Remove a path because it looks unused without checking who uses it and what they do next.
- Ship a redesign with no way back. Keep the old path reachable until the new one is proven.
Return contract
Findings by category with severity, the sequenced plan, what you would do first if only one day were available, and what you deliberately are not touching.
Files (headcount)
-
references
-
sources.md 2.1 KB
# Sources — `product:interface-redesign` <!-- Generated by scripts/build-sources.py from sources/*.toml. Do not edit. --> Check these before answering on anything they cover, and cite what you used. The use note on each one is binding: most of what a professional cites is free to read and not free to reproduce. ## CCPA regulations, California Code of Regulations title 11 California Privacy Protection Agency · US-CA · public domain — quote freely <https://cppa.ca.gov/regulations/consumer_privacy_act.html> **Authoritative for:** Symmetry in choice, as law. It settles whether a consent flow where accepting is one click and declining is three is permissible — converting what is usually argued as design taste into a compliance question. ## Human Interface Guidelines Apple · global · **read and cite only — copyrighted, do not reproduce** <https://developer.apple.com/design/human-interface-guidelines> **Authoritative for:** What correct platform behavior is on Apple platforms — control semantics, navigation structure, touch targets. Its authority is not taste: deviation is grounds for review rejection. ## WAI-ARIA and the ARIA Authoring Practices Guide World Wide Web Consortium · global · **read and cite only — copyrighted, do not reproduce** <https://www.w3.org/WAI/ARIA/apg/> Machine-readable: <https://www.w3.org/TR/wai-aria-1.2/> **Authoritative for:** Which roles, states and keyboard interactions a given widget must implement. Settles whether Escape should close a dialog and whether a role is the right one, without appeal to preference. ## Web Content Accessibility Guidelines 2.2 World Wide Web Consortium · global · **read and cite only — copyrighted, do not reproduce** <https://www.w3.org/TR/WCAG22/> **Authoritative for:** Whether a page, email or video is accessible. It is the criteria list that US Section 508, the EU's EN 301 549 and most enterprise procurement point at, so it settles any argument that reaches a buyer's accessibility requirement. --- Sources are maintained in `sources/` upstream, not here. If one is wrong, out of date, or missing, fix it there — this file is regenerated and an edit to it is lost.
-
-
SKILL.md 3.2 KB
--- name: interface-redesign description: Upgrades an existing interface to a higher standard without rebuilding it — auditing what is there, identifying what reads as generic or unfinished, and sequencing changes by impact. Use this when a product works but looks dated or default, when a redesign is being considered, when deciding whether to restyle or rebuild, or when a screen needs to look substantially better with limited effort. --- # Interface redesign Most interfaces do not need rebuilding. They need a dozen specific things fixed, in the right order. ## Audit first Go through the real product, on a real device, doing a real task. Record what you find in these categories — the order is the priority order: 1. **Structural** — unclear primary action, competing focal points, navigation that does not match the mental model. These are the only ones worth a rebuild. 2. **Systemic** — inconsistent spacing, more type sizes than a scale would allow, palette drift, components that exist in variants. High impact, mechanical to fix. 3. **Craft** — weak hierarchy, poor contrast, unfinished states, cramped density. 4. **Cosmetic** — dated shadows, default border radii, stock illustration. ## The generic-AI-product tells These are the specific things that make a product read as unconsidered. They are worth naming because they are all cheap to fix: - Default framework styling left in place — the untouched button, the starter-template card. - One accent color used for every emphasis, so nothing is emphasized. - Uniform spacing everywhere, so nothing groups. - Centered everything, including body copy. - Emoji standing in for iconography. - Gradients on surfaces that carry no meaning. - Empty and error states that were never designed. ## Sequencing Fix in this order, because each makes the next easier to see: 1. Tokens — spacing scale, type scale, palette. This alone resolves most systemic findings. 2. Hierarchy on the two or three highest-traffic screens. 3. States: empty, loading, error, overflow. 4. Component consolidation. 5. Cosmetic pass. ## Restyle or rebuild Rebuild only when the structure is wrong — when the information architecture does not match how people work. Everything else is a restyle, and a restyle that ships beats a rebuild that stalls. ## Sources `references/sources.md` in this skill lists the outside authorities that settle the questions here — what each one is authoritative for, and what you may do with it. Check them before answering on anything they cover, and cite what you used. Most are free to read and not free to reproduce; the use note on each is binding. ## Never - Restyle a screen whose problem is structural. New paint on a broken flow buys nothing. - Change navigation and visual language in the same release. When something breaks you will not know which one did it. - Remove a path because it looks unused without checking who uses it and what they do next. - Ship a redesign with no way back. Keep the old path reachable until the new one is proven. ## Return contract Findings by category with severity, the sequenced plan, what you would do first if only one day were available, and what you deliberately are not touching.
Comments (0)
Sign in to join the conversation.
Reviews (0)
No reviews yet.
No comments yet.