establish-visual-hierarchy

star 169

Determine what UI element draws attention first, second, third using size, weight, color, and de-emphasis strategies

gnurio By gnurio schedule Updated 4/26/2026

name: establish-visual-hierarchy description: Determine what UI element draws attention first, second, third using size, weight, color, and de-emphasis strategies domain: ui-design skill-type: evaluative version: 1.0.0 author: refactoring-ui-expert prerequisites: [] dependencies: [] input: - design_description: string - element_list: array of {element, importance} output: - assessment: PASS | FAIL - ranked_elements: array - recommendations: array of strings

Skill: Establish Visual Hierarchy

Purpose

Determine what UI element should draw attention first, second, third. Visual hierarchy controls the order in which users process information using size, weight, color, and de-emphasis strategies.

Quick Reference

Strategy When to Use
Size + Weight Primary headlines, important CTAs
Color Contrast Secondary content, supporting text
De-emphasize When primary isn't standing out
Weight/Contrast Balance Icons next to text, borders

Execution Workflow

Step 1: Identify Primary Element

  • What is the single most important thing on this screen?
  • What action should the user take?
  • What information is critical?

Step 2: Assess Current Hierarchy

Check visual weight of each element:

  • Size: Larger = more attention
  • Weight: Bolder = more importance
  • Color: Higher contrast = more prominent
  • Whitespace: More surrounding space = stands out

Step 3: Apply Multi-Factor Hierarchy

Don't rely on size alone:

  1. Use weight (600-700) for emphasis
  2. Use color (grey scale) to de-emphasize
  3. Keep sizes reasonable

Step 4: De-emphasize Competitors

If primary element isn't standing out:

  • Reduce contrast of surrounding elements
  • Use softer colors for secondary content
  • Remove unnecessary backgrounds

Decision Criteria

PASS

  • Most important element has highest visual weight
  • Hierarchy uses weight/color, not just size
  • Surrounding elements are subdued
  • Clear visual path: primary → secondary → tertiary

FAIL

  • Relying solely on font size
  • Everything equally emphasized
  • Critical elements buried
  • Decorative elements competing

Common Patterns

Pattern: Marketing Page Hero

H1: 48px, weight 700, dark    ← Primary
CTA: 16px, solid brand color  ← Secondary
Body: 16px, weight 400, grey  ← Tertiary

Pattern: Dashboard Card

Metric: 32px, weight 700      ← Primary
Label: 14px, weight 400, grey ← Secondary
Action: Text link, brand color ← Tertiary

Anti-Patterns

Anti-Pattern Why It Fails Fix
Logo larger than headline Brand over value Reduce logo, increase headline
60px headline, 12px body Size extremes Use 40px + weight, 16px body
All bold text Nothing stands out Use weight hierarchy
Large section titles Content buried Make titles smaller than content

References

  • references/size-isnt-everything.md
  • references/emphasize-by-de-emphasizing.md
  • references/ignore-document-hierarchy.md

Examples

See examples/visual-hierarchy/ for before/after cases.

Install via CLI
npx skills add https://github.com/gnurio/refactoring-ui-plugin --skill establish-visual-hierarchy
Repository Details
star Stars 169
call_split Forks 11
navigation Branch main
article Path SKILL.md
More from Creator