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 · 21 views 0 listing impressions 0 install-command copies
Download cbrock84-headcount-plugins_product_skills_interface-redesign-98d1c17.zip · 2 KB
This skill couldn't be refreshed from GitHub on the last check — you're seeing the last imported snapshot.

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
      Loading…
  • 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.