Claude Skill

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

LLM Mart · 0 points · 18 views 0 listing impressions 0 install-command copies
Virus-scanned Reviewed automatically before listing.

Full trust report

Download cbrock84-headcount-plugins_product_skills_interface-redesign-98d1c17.zip · 2 KB
Part of cbrock84/headcount — 160 skills

Install

skills CLI npx skills add https://github.com/cbrock84/headcount/tree/main/plugins/product/skills/interface-redesign
Claude Code claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install cbrock84-headcount@llmmart
Git 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:

  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.

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.

No comments yet.

Reviews (0)

No reviews yet.

Related