von-restorff-effect — Claude Code skill: what it does, how to install
This skill guides coding agents to isolate a single primary action on a screen using visual contrast. It applies when one choice must grab attention immediately.
npx skills add Owl-Listener/designer-skills --skill von-restorff-effect -a claude-codeWhat von-restorff-effect does
The skill implements the Von Restorff effect, also known as the isolation effect: an item differing from its surroundings is noticed and recalled faster. Visual homogeneity serves as the baseline, while intentional deviation draws the eye. The agent checks that contrast is earned rather than scattered across the layout.
Inside the prompt is a set of UI patterns. It covers primary call-to-action buttons among ghost variants, highlighted pricing tiers, active navigation states, and table row emphasis. To preserve accessibility, the skill insists on combining color changes with size, shape, or weight differences. Contrast must survive grayscale and colorblindness checks.
Focus decays when multiple components compete for prominence. If you need to arrange the reading flow across an entire screen instead of highlighting a single element, use visual-hierarchy instead.
What it helps with
- emphasize a recommended plan inside a pricing table
- make the primary call-to-action distinct from secondary buttons
- isolate the active step during user onboarding
- highlight an important record in a data table
Example prompts for the agent
- Make the recommended pricing tier stand out from the other two plans
- Review this button row so only the submit action has a filled background
- Isolate the current onboarding step visually from upcoming steps
How to install von-restorff-effect
1Skills CLI (Vercel)
npx skills add Owl-Listener/designer-skills --skill von-restorff-effect -a claude-code2Manually: put the files in place
~/.claude/skills/von-restorff-effect/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/von-restorff-effect/
1Skills CLI (Vercel)
npx skills add Owl-Listener/designer-skills --skill von-restorff-effect -a codex2Manually: put the files in place
.agents/skills/von-restorff-effect/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add Owl-Listener/designer-skills --skill von-restorff-effect -a cursor2Manually: put the files in place
.cursor/skills/von-restorff-effect/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install Owl-Listener/designer-skills von-restorff-effect2Manually: put the files in place
.github/skills/von-restorff-effect/SKILL.md1Skills CLI (Vercel)
npx skills add Owl-Listener/designer-skills --skill von-restorff-effect -a gemini-cli2Platform CLI
gemini skills install https://github.com/Owl-Listener/designer-skills --path ui-design/skills/von-restorff-effectManually: put the files in place
.devin/skills/von-restorff-effect/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add Owl-Listener/designer-skills --skill von-restorff-effect -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 von-restorff-effect
How to install von-restorff-effect in Claude Code?
Run npx skills add Owl-Listener/designer-skills --skill von-restorff-effect -a claude-code. The skill file is placed in ~/.claude/skills/von-restorff-effect/SKILL.md.
What does von-restorff-effect do?
It instructs the agent to create visual contrast for a single dominant element, such as a primary button or a featured pricing card.
When should you use visual-hierarchy instead of von-restorff-effect?
Use von-restorff-effect when one specific element must dominate the screen. For overall structural ordering across the entire layout, switch to visual-hierarchy.
Source text
SKILL.md · MIT
--- name: von-restorff-effect description: Apply the Von Restorff Effect — the element that differs from its neighbours is the one remembered. Use when a single action must dominate. For overall ordering rather than single-element emphasis, use `visual-hierarchy`. --- # Von Restorff Effect You are an expert in visual differentiation and its effect on memory and attention. ## What You Do You apply the Von Restorff Effect (also called the Isolation Effect) to ensure the one element that most needs attention is visually distinct — and that distinctiveness is earned, not scattered. ## The Principle An item that differs from its surroundings is more likely to be **noticed and remembered**. Visual homogeneity is the baseline; deviation draws the eye. This is why: - A single filled button in a row of ghost buttons captures attention - A highlighted row in a table reads as the most important item - A price, CTA, or warning stands out when surrounded by lower-contrast elements ## Key Distinction The effect depends on **contrast with context**. If everything is differentiated, nothing is. The principle only works when: - One (or very few) items deviate - Surrounding items are visually consistent with each other - The deviation is meaningful, not decorative ## Applications | Context | How to Apply | |---|---| | Call to action | One filled/primary button; all others ghost or text | | Pricing | Highlight one recommended tier; reduce visual weight of others | | Navigation | Active state distinctly different from inactive | | Data tables | Use row highlight or bold type for the key record | | Notifications | Badge or accent color reserved for actionable items only | | Onboarding | One step or card at a time, visually isolated from upcoming steps | ## What to Avoid - Applying the effect to multiple competing elements (defeats the purpose) - Using it decoratively — random pops of color train users to ignore them - Relying solely on color — pair with shape, size, or weight for accessibility ## Best Practices - Decide in advance what the single most important element per screen or section is - Audit for "isolation inflation" — every new feature requesting highlight treatment degrades the system - Ensure the differentiated element is distinct on all states: hover, focus, disabled - Test with colorblindness simulation; differentiation should survive grayscale
© Owl-Listener · MIT · Owl-Listener/designer-skills