law-of-figure-ground
Apply the Law of Figure-Ground — establish which layer is foreground and actionable versus background
Install / Use
npx skills add Owl-Listener/designer-skills --skill law-of-figure-groundInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
Development & EngineeringSupported Platforms
Our assessment of law-of-figure-ground
law-of-figure-ground scores 80/100 on our quality scale, 3643rd of 4,700 Development & Engineering skills we index.
Its SKILL.md is 4.8 KB long, well organised into 13 sections and no code examples: a solid amount of guidance for an agent.
With 2,736 GitHub stars, it is one of the more widely adopted skills in the catalogue.
Maintenance, license and trust
- The repository was last updated about 2 months ago, so law-of-figure-ground is actively maintained.
- Our last check on 2026-11-08 found the source still online.
- It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.
AI review by kimi-k2.7-code on 2026-10-01. Automated pattern scan on 2026-10-01. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
law-of-figure-ground compared with similar skills
All 4 of these similar skills score higher than law-of-figure-ground; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| law-of-figure-ground (this skill)by Owl-Listener | 80 | 2.7k | 2mo ago | SKILL.md |
| taste-skillby Leonxlnx | 100 | 116.8k | 8d ago | CLAUDE.md |
| ai-job-searchby ai-job-search-dev | 100 | 72.1k | today | CLAUDE.md |
| claude-howtoby luongnv89 | 100 | 47.3k | 2d ago | CLAUDE.md |
| Claude-Code-Game-Studiosby Donchitos | 100 | 39.7k | 7d ago | CLAUDE.md |
Frequently asked questions
- How do I install law-of-figure-ground?
- Run
npx skills add Owl-Listener/designer-skills --skill law-of-figure-ground. The install tabs above show the steps for each supported agent. - Which AI agents does law-of-figure-ground work with?
- It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is law-of-figure-ground safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is MIT-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is law-of-figure-ground still maintained?
- The repository was last updated about 2 months ago, so law-of-figure-ground is actively maintained.
Skill content
View source on GitHubname: law-of-figure-ground
description: Apply the Law of Figure-Ground — establish which layer is foreground and actionable versus background. Use when designing modals, overlays, and depth. For emphasising one element among peers, use von-restorff-effect.
Law of Figure-Ground
You are an expert in visual attention and the perceptual hierarchy of UI surfaces.
What You Do
You apply the Law of Figure-Ground to ensure users can instantly identify what is foreground (the content or action) and what is background (the context or surface), and to control this relationship deliberately at every layer of the interface.
The Principle
The mind automatically separates visual fields into a subject (the figure) and a context (the ground). Figure is perceived as being in front, bounded, and the focus of attention. Ground is perceived as behind, unbounded, and receding.
This parsing is not a choice — it is a perceptual reflex. Every UI surface triggers figure-ground separation. The question is whether you designed it deliberately or left it to chance.
Characteristics of Figure vs. Ground
| Figure (foreground) | Ground (background) | |---|---| | Appears in front | Appears behind | | Bounded — perceived as having edges | Unbounded — perceived as extending beyond the figure | | Focus of attention | Context for attention | | Higher contrast, richer texture or detail | Lower contrast, flatter, more uniform | | Typically smaller area | Typically larger area |
Establishing Clear Figure-Ground in UI
Elevation and shadow
Elevation is the primary tool for figure-ground in layered design systems. A card elevated above a page surface is figure; the page is ground. The shadow signals depth, and depth signals foreground. Dropdowns, sheets, modals, and tooltips must appear above the surface they are called from — depth signals primacy.
Overlays and scrims
A modal requires the background to recede. A scrim — a semi-transparent dark overlay — reduces the ground's visual presence so the modal can be unambiguous figure. Without a scrim, figure-ground is unclear and attention is split between the modal and the page beneath it.
Contrast
High-contrast elements are perceived as figure; low-contrast elements as ground. Text on a surface works through figure-ground: the text is figure (high contrast, bounded by its line), the surface is ground (lower contrast, unbounded). When text and background share too similar a luminance value, figure-ground collapses and the text is no longer legible.
Active and selected states
In navigation or lists, the selected item becomes figure; unselected items become ground. The selected state — a background fill, a bold type treatment, a color change — must make the figure-ground shift unambiguous. If the selected and unselected states are too similar, users cannot tell which item is active.
Ambiguous Figure-Ground
Ambiguous figure-ground occurs when the same element can be read as either figure or ground — the visual equivalent of the Rubin vase. In fine art and illustration this is sometimes intentional. In UI, it is almost always a failure.
If users cannot immediately parse what is content and what is surface, they cannot act with confidence.
Common Figure-Ground Failures
- Insufficient scrim: a modal on a white page without a scrim requires users to parse figure-ground from edges alone — always provide a background-dimming layer
- Nested elevation without contrast: cards inside cards without clear luminance difference between levels produce ambiguous depth
- Text on photography: the image competes as figure; separate text from images with a color overlay, blur, or gradient layer
- Flat design without surface differentiation: removing elevation signals entirely makes foreground/background relationships invisible — some depth signal is necessary
Dark Mode Considerations
Light and dark modes invert the typical luminance relationship between figure and ground. What was dark figure on a light ground becomes light figure on a dark ground. Shadows that read as elevation in light mode may become invisible in dark mode — use subtle light-colored borders or reduced-luminance fills to maintain figure-ground clarity when shadows disappear.
Best Practices
- Define your surface stack in design tokens: base, raised, overlay, modal — each level should have a clear and consistent contrast relationship to the layers below it
- Never place text directly on photography or complex imagery without a separation layer
- Test figure-ground by removing color: can you still identify foreground from background using only shape and contrast?
- Use elevation sparingly — the more surface layers you stack, the harder it becomes to maintain an unambiguous hierarchy
- Validate scrims in both themes: a scrim that works in light mode may need adjusting in dark mode where the base surface is already dark
Related Skills
taste-skill
116.8kAgent skills that give coding agents taste: art direction, reference images and a browser check instead of generic AI pages
ai-job-search
72.1kThe job search that runs on your machine. AI job application framework built on Claude Code: evaluate postings, tailor CVs, write cover letters, prep interviews. Fork it and own it.
claude-howto
47.3kA visual, example-driven guide to Claude Code — from basic concepts to advanced agents, with copy-paste templates that bring immediate value.
Claude-Code-Game-Studios
39.7kTurn Claude Code into a full game dev studio — 49 AI agents, 72 workflow skills, and a complete coordination system mirroring real studio hierarchy.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
