critique-visual-hierarchy — Claude Code skill: screen hierarchy
This skill reviews a rendered screen across four dimensions and tells you where the eye actually lands. Useful when attention goes to the wrong place.
npx skills add Owl-Listener/designer-skills --skill critique-visual-hierarchy -a claude-codeWhat critique-visual-hierarchy does
The skill takes a rendered screen and checks whether the hierarchy is clear and matches user goals. It works through four dimensions: entry point, eye flow, weight, and emphasis. For each one it returns an observation, a problem, and a specific fix, then rates the dimension pass, minor issue, or major issue.
Inside is a set of checks. Is there a single dominant element, or does attention scatter? Does the flow lead to the primary call-to-action? Are size differentials wide enough between hierarchy levels? Do background fill, stroke weight, and icons support the hierarchy or fight it? It also lists common failure patterns: competing primaries, hierarchy flattening, false emphasis, and a buried CTA.
This is critique of an existing screen, not hierarchy building from scratch. For new work the description points to a different skill, visual-hierarchy in the ui-design set. If your problem is that attention lands on the wrong block, this is the one to reach for.
What it helps with
- find which element captures the eye first
- check whether flow leads to the primary action
- spot hierarchy flattening in size and weight
- separate real emphasis from decoration
- get per-dimension fixes with a rating
Example prompts for the agent
- critique the hierarchy of this screen: entry point, eye flow, weight, emphasis
- look at the screenshot and tell me why attention misses the button
- rate the hierarchy across the four dimensions and give me fixes
How to install critique-visual-hierarchy
1Skills CLI (Vercel)
npx skills add Owl-Listener/designer-skills --skill critique-visual-hierarchy -a claude-code2Manually: put the files in place
~/.claude/skills/critique-visual-hierarchy/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/critique-visual-hierarchy/
1Skills CLI (Vercel)
npx skills add Owl-Listener/designer-skills --skill critique-visual-hierarchy -a codex2Manually: put the files in place
.agents/skills/critique-visual-hierarchy/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add Owl-Listener/designer-skills --skill critique-visual-hierarchy -a cursor2Manually: put the files in place
.cursor/skills/critique-visual-hierarchy/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install Owl-Listener/designer-skills critique-visual-hierarchy2Manually: put the files in place
.github/skills/critique-visual-hierarchy/SKILL.md1Skills CLI (Vercel)
npx skills add Owl-Listener/designer-skills --skill critique-visual-hierarchy -a gemini-cli2Platform CLI
gemini skills install https://github.com/Owl-Listener/designer-skills --path visual-critique/skills/critique-visual-hierarchyManually: put the files in place
.devin/skills/critique-visual-hierarchy/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add Owl-Listener/designer-skills --skill critique-visual-hierarchy -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about critique-visual-hierarchy
How do I install critique-visual-hierarchy in Claude?
Run npx skills add Owl-Listener/designer-skills --skill critique-visual-hierarchy -a claude-code. The skill lands at ~/.claude/skills/critique-visual-hierarchy/SKILL.md.
What does critique-visual-hierarchy do?
It reviews a rendered screen across entry point, eye flow, weight, and emphasis. Each dimension gets an observation, a problem, and a fix.
How is it different from visual-hierarchy?
This skill critiques a screen that already exists. For establishing hierarchy in new work, the description points to visual-hierarchy in the ui-design set.
Source text
SKILL.md · MIT
--- name: critique-visual-hierarchy description: Critique a rendered screen's hierarchy — entry point, eye flow, weight distribution, and emphasis. Use when attention lands in the wrong place. For establishing hierarchy in new work, use `visual-hierarchy` (ui-design). --- # Critique Visual Hierarchy You are an expert in visual hierarchy and screen-level design critique. ## What You Do You analyse a screen to identify whether hierarchy is clear, intentional, and aligned with user goals. You flag problems and suggest targeted fixes. ## Critique Dimensions ### Entry Point The first element that captures the eye. Evaluate whether it is the *most important* thing on screen. - Is there a single dominant element, or does attention scatter? - Does size, contrast, or position establish the entry point clearly? - Does the entry point match the primary user goal for this screen? ### Eye Flow The path a user's eye travels after landing. Evaluate whether the path is deliberate and efficient. - Does the layout follow an F-pattern, Z-pattern, or intentional reading order? - Are there dead ends, loops, or confusing jumps? - Does flow lead naturally to the primary call-to-action? ### Weight The relative visual importance of each element. Evaluate whether weight is distributed purposefully. - Are size differentials at least 1.5× between hierarchy levels? - Is bold/heavy type used sparingly so it retains signal value? - Do background fill, stroke weight, and iconography add or fight the hierarchy? ### Emphasis Specific elements that demand extra attention. Evaluate whether emphasis is earned and singular. - Is there exactly one primary emphasis zone per view? - Are colour, contrast, or motion used to emphasise — or overused so they cancel out? - Does the highest-emphasis element match stakeholder and user priority? ## Output Format For each dimension — Entry Point, Eye Flow, Weight, Emphasis — provide: 1. **Observation** — what you see (neutral, factual) 2. **Problem** — what is broken and why it matters 3. **Fix** — a specific, actionable change Rate each dimension: `pass` / `minor issue` / `major issue`. ## Common Failure Patterns - Multiple competing primaries — nothing reads as most important - Hierarchy flattening — too similar in size, weight, or colour across levels - False emphasis — decorative elements outweigh functional ones - Buried CTA — the action is visually quieter than surrounding content
© Owl-Listener · MIT · Owl-Listener/designer-skills