Agent skill

Figure Ground Relationship

by hashgraph-online in hashgraph-online/awesome-codex-plugins

Apply the Gestalt principle of Figure-Ground Relationship — the perceptual separation of what's perceived as the figure (the focus, the object) from the ground (the surrounding context).

Apache-2.0Auto-check passed

Install Figure Ground Relationship

skills CLI
$ npx skills add hashgraph-online/awesome-codex-plugins --skill figure-ground-relationship -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install hashgraph-online/awesome-codex-plugins figure-ground-relationship --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/hashgraph-online/awesome-codex-plugins.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/HDeibler/universal-design-principles/plugins/perception-and-hierarchy-principles/skills/figure-ground-relationship .claude/skills/figure-ground-relationship && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
figure-ground-relationship
GitHub stars
1.3k
Token cost
~2.2k tokens
SKILL.md length
1,186 words
Files
2 (incl. references)
Skills in repo
714
Repo updated
First seen
Licence
Apache-2.0

At a glance

Apply the Gestalt principle of Figure-Ground Relationship — the perceptual separation of what's perceived as the figure (the focus, the object) from the ground (the surrounding context).

  • Designing modals
  • SKILL.md covers The cues that signal figure, Why figure-ground matters, Sub-skills in this cluster and Worked examples, plus 4 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • Hover treatments

What it does

Figure Ground Relationship is an agent skill from hashgraph-online/awesome-codex-plugins. Apply the Gestalt principle of Figure-Ground Relationship — the perceptual separation of what's perceived as the figure (the focus, the object) from the ground (the surrounding context). Use when designing modals, overlays, focus states, hero elements, hover treatments, layered interfaces, or any context where one element should clearly stand forward against everything else. The user's perception always sorts the visual field into figure and ground; designs that reinforce the desired sorting feel clear, while…

Its SKILL.md is about 2.2k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including reference files (for example `references/lineage.md`).

The repository describes itself as: A curated list of awesome OpenAI Codex / ChatGPT plugins, skills, and resources. The 1 Codex Marketplace. See live plugins at: https://hol.org/plugins/best-codex-plugins. The licence is Apache-2.0.

When your agent uses it

  • Designing modals
  • Hover treatments
  • Layered interfaces
  • Any context where one element should clearly stand forward against everything else

Example prompts

  • “/figure-ground-relationship”

What it can do on your machine

Read from SKILL.md and the folder at commit 9e7b281. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Figure Ground Relationship loads about 2.2k tokens when it runs, and up to ~3.9k if it reads all its reference files. Until then it costs about 145 tokens; SKILL.md has 1,186 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~145
When it runs · the whole SKILL.md, loaded when a task matches
~2.2k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~3.9k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from hashgraph-online/awesome-codex-plugins at commit 9e7b281, republished under its Apache-2.0 licence (© hashgraph-online). 1,186 words, ~2,217 tokens.

Download SKILL.mdSave it as .claude/skills/figure-ground-relationship/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
figure-ground-relationship
description
Apply the Gestalt principle of Figure-Ground Relationship — the perceptual separation of what's perceived as the figure (the focus, the object) from the ground (the surrounding context). Use when designing modals, overlays, focus states, hero elements, hover treatments, layered interfaces, or any context where one element should clearly stand forward against everything else. The user's perception always sorts the visual field into figure and ground; designs that reinforce the desired sorting feel clear, while designs that fight it feel confusing.

Figure-Ground Relationship

Definition. Figure-ground relationship is the perceptual principle that the visual field is automatically sorted into "figure" (the object of focus, the thing perceived as standing forward) and "ground" (the context, the thing perceived as receding behind). The sorting is automatic and pre-conscious; the user doesn't choose what's figure and what's ground. The designer's job is to ensure that what should be figure (the active element, the focal point, the modal content) reads as figure, and that what should be ground (the chrome, the inactive content, the background) reads as ground.

The classic illustration is the Rubin vase — a figure that can be perceived either as a vase (with the surroundings as ground) or as two faces in profile (with the vase shape as ground). The image is deliberately ambiguous; the visual system flips between the two interpretations because neither has clear primacy.

In design we usually want unambiguous primacy. The active workspace should clearly be figure; the chrome around it should clearly be ground. The modal should clearly be figure; the page underneath should clearly recede. The hovered item should clearly come forward; the rest should fade.

The cues that signal figure

The visual system uses several cues to decide what's figure and what's ground.

Definite, closed shape. Elements with clear, complete boundaries are perceived as figure. Loose or open shapes are perceived as ground.

Apparent closeness. Elements that appear closer (through shadow, scale, or perspective) are perceived as figure. Elements that recede are ground.

Lower position in the visual field. Elements positioned in the lower part of the field tend to be perceived as figure (a heuristic from real-world perception, where ground is usually at the bottom).

Smaller area. Smaller elements are typically perceived as figure against larger backgrounds, not the reverse.

Higher contrast or saturation. Brighter, more saturated, more contrasting elements come forward. Muted, low-contrast elements recede.

Texture and detail. More detailed elements come forward; smoother, less detailed elements recede.

Symmetry. Symmetric shapes tend to be perceived as figure.

Overlapping (occlusion). Elements that occlude others are perceived as in front, hence as figure.

These cues compound. A small, sharply-defined, highly-contrasting element overlaying a large, muted, smoothly-textured background is unambiguously figure.

Why figure-ground matters

When figure-ground is clear, the user knows where to look without effort. The active task is figure; the rest is ground. Their attention naturally goes to the figure.

When figure-ground is ambiguous, the user has to do attention work — actively deciding what to focus on. This is tiring and slow. Layouts where everything competes for visual primacy feel chaotic; layouts where nothing has primacy feel flat.

When figure-ground is reversed (the wrong element comes forward), the user is misled about where the focus is supposed to be. They may miss the intended focal point and pay attention to something that isn't important.

Sub-skills in this cluster

  • figure-ground-cues — The specific visual cues (shadow, scale, contrast, detail) that signal figure vs. ground, and how to apply them deliberately.
  • figure-ground-overlays-and-modals — The most common figure-ground design problem: overlays, modals, popovers that need to clearly come forward over the underlying page.

Worked examples

A modal with clear figure-ground

A modal opens over the page. The page content fades to lower opacity (becomes ground). A scrim (semi-transparent overlay) further separates the page from the modal. The modal itself has a sharp white background, a clear edge with shadow, and full saturation.

The user's perception clearly sorts: modal is figure, page is ground. Attention naturally goes to the modal. When the modal closes, the page returns to figure status.

A modal with weak figure-ground

A modal opens but the page beneath isn't visually changed (no scrim, no opacity change). The modal has a subtle border but no shadow. The figure-ground separation is weak — the modal feels like another panel on the page rather than a focused overlay.

Users can be unsure where to focus. The modal's interactivity isn't visually emphasized. The figure-ground principle hasn't done its work.

The fix: add a scrim, increase the modal's elevation (more shadow), make the page beneath visibly recede.

Hover state with figure-ground

When a user hovers over an item in a list, the item gets a slightly lifted appearance — slightly elevated shadow, slightly more saturation, slightly larger. The other items remain ground.

The hover-triggered figure-ground shift signals interactivity and gives the user feedback about where their attention is.

Show full SKILL.md (462 more words)Show less
A dashboard where everything competes

A dashboard has 8 large cards, all with similar styling, similar weight, similar prominence. The user has no clear focal point. Every card feels like figure; nothing feels like ground.

The fix: introduce visual hierarchy through figure-ground cues. Make the most important card larger or more prominent (figure). Keep supporting cards smaller and less emphasized (ground). The user's attention now has a clear target.

Active vs. inactive workspace

An app has multiple workspaces visible (a current one and recent ones). The current workspace is rendered with full saturation, sharp shapes, and prominent contrast. The recent workspaces are rendered with reduced opacity, slightly muted colors. The figure-ground separation makes the current workspace clearly active.

If both had been styled identically, users would have to read carefully to know which workspace was active. The figure-ground cue does the work.

Anti-patterns

Reversed figure-ground. The chrome (sidebars, headers) styled more prominently than the content. Users look at the chrome instead of the content.

No figure-ground separation. Layouts where everything has the same visual weight. Nothing feels primary; users don't know where to focus.

Modals that don't come forward enough. Insufficient scrim, no elevation cues. The modal blurs into the page.

Overlays that come forward too aggressively. Heavy darkening of the background, dominant overlays that feel intrusive. The figure-ground separation is too aggressive and the user feels assaulted.

Inconsistent figure-ground treatment across the product. Modals styled differently in different places; some come forward more than others. Users can't form expectations.

Background imagery that competes with foreground. A photo background under text where the text is hard to read because the photo is so visually rich. The figure-ground sorting is unclear.

Heuristic checklist

When designing a layout, ask: What should be figure (the focal point) and what should be ground (the context)? Be explicit about the intended sorting. Are the visual cues reinforcing the desired sorting? Shadow, contrast, scale, saturation should align. At a glance, can the user identify what's primary? If they have to think about it, the figure-ground is weak. Does the figure-ground sorting hold up when state changes? A modal opens, a hover happens, an item gets selected — figure-ground should re-sort cleanly.

  • Gestalt grouping principles generally — figure-ground is one of the original Gestalt principles.
  • Hierarchy — figure-ground is a primary mechanism for expressing hierarchy.
  • Signal-to-Noise Ratio — figure should have high signal; ground should have low.
  • Color — color choice affects figure-ground (saturated colors come forward, muted recede).
  • Closure — closed forms are more likely to be perceived as figure.
  • Layering — explicit visual layering is a tool for figure-ground design.

See also

  • references/lineage.md — origins in Gestalt psychology and the Rubin vase.
  • figure-ground-cues/ — sub-skill on the specific visual cues that signal figure vs. ground.
  • figure-ground-overlays-and-modals/ — sub-skill on the most common figure-ground design problem.

© hashgraph-online, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file (references) in plugins/HDeibler/universal-design-principles/plugins/perception-and-hierarchy-principles/skills/figure-ground-relationship of hashgraph-online/awesome-codex-plugins.

  • SKILL.md
  • references/lineage.md

Open the folder on GitHubat commit 9e7b281

Compare with similar skills

Figure Ground Relationship next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Figure Ground Relationship compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Figure Ground Relationship this skillhashgraph-online/awesome-codex-plugins1.3k—~2.2kAutomated safety check: PassApache-2.0
Law Of Figure GroundOwl-Listener/designer-skills2.9k—~1.2kAutomated safety check: PassMIT
Figurevectorize-io/hindsight47k—~1.9kAutomated safety check: PassMIT
Principle Separate Before Serializing Shared Statecursor/plugins10k8 repos~392Automated safety check: PassNone
Principle Redesign From First Principlescursor/plugins10k8 repos~211Automated safety check: PassNone
Nature-Style Scientific FiguresYuan1z0825/nature-skills47k—~2.9kAutomated safety check: PassApache-2.0

Similar skills

  • Law Of Figure Ground

    Owl-Listener/designer-skills

    Apply the Law of Figure-Ground — establish which layer is foreground and actionable versus background.

    2.9k GitHub stars~1.2k tokensUpdated 1 mo ago
    Frontend & DesignAuto-check passed
  • Figure

    vectorize-io/hindsight

    Draw an animated figure (boxes, arrows, moving data) as one self-contained SVG for a GitHub README, PR, issue or blog post.

    47k GitHub stars~1.9k tokensUpdated yesterday
    Writing & ContentAuto-check passed
  • Nature-Style Scientific Figures

    Yuan1z0825/nature-skills

    Creates, revises, audits and exports manuscript-ready scientific figures in Python or R, and routes AI-generated graphical abstracts to a separate workflow.

    47k GitHub stars~2.9k tokensUpdated yesterday
    Research & ScienceAuto-check passed
  • Figure Figcaption

    thedaviddias/Front-End-Checklist

    A skill your agent uses when reviewing image assets, markup, and CDN or build transforms related to Use <figure and <figcaption for image captions.

    74k GitHub stars~816 tokensUpdated 3 days ago
    Auto-check passed

More from hashgraph-online/awesome-codex-plugins

All 714 skills in this repo
  • Anime Reaction Gif

    hashgraph-online/awesome-codex-plugins

    Create original anime-style reaction stickers as looping GIFs and MP4 previews, using generated character pose sheets and timed key poses.

    1.3k GitHub stars~922 tokensUpdated today
    Auto-check passed
  • Calibredb

    hashgraph-online/awesome-codex-plugins

    Manage and query Calibre libraries with the calibredb CLI (local paths or Calibre Content server URLs).

    1.3k GitHub stars~1k tokensUpdated today
    Auto-check passed
  • Rust API Test Harness

    hashgraph-online/awesome-codex-plugins

    A skill your agent uses when adding, changing, testing, or debugging Rust HTTP APIs and services, especially when Codex needs black-box integration tests, random-port app startup, real database test…

    1.3k GitHub stars~1.7k tokensUpdated today
    Auto-check passed
  • Art

    hashgraph-online/awesome-codex-plugins

    Make a studio's game look like something at build time — a cover from a real frame of the game (free), painted covers, backdrops, textures and character plates from image models through the…

    1.3k GitHub stars~2.4k tokensUpdated today
    Auto-check passed
  • Calle

    hashgraph-online/awesome-codex-plugins

    Use CALL-E from Codex through the calle CLI. An agent skill from hashgraph-online/awesome-codex-plugins.

    1.3k GitHub stars~2.9k tokensUpdated today
    Auto-check passed
  • Game Balance Economy

    hashgraph-online/awesome-codex-plugins

    Balance game difficulty, resources, rewards, probability, progression, economies, and dominant strategies.

    1.3k GitHub stars~618 tokensUpdated today
    Auto-check passed

Questions about Figure Ground Relationship

What does Figure Ground Relationship do?

Apply the Gestalt principle of Figure-Ground Relationship — the perceptual separation of what's perceived as the figure (the focus, the object) from the ground (the surrounding context). Figure Ground Relationship is an agent skill from hashgraph-online/awesome-codex-plugins. Apply the Gestalt principle of Figure-Ground Relationship — the perceptual separation of what's perceived as the figure (the focus, the object) from the ground (the surrounding context).

When should I use Figure Ground Relationship?

Figure Ground Relationship fits situations like: designing modals; hover treatments; layered interfaces; any context where one element should clearly stand forward against everything else.

How do I install Figure Ground Relationship in Claude Code?

Run `npx skills add hashgraph-online/awesome-codex-plugins --skill figure-ground-relationship -a claude-code`. Or copy the skill folder (plugins/HDeibler/universal-design-principles/plugins/perception-and-hierarchy-principles/skills/figure-ground-relationship in hashgraph-online/awesome-codex-plugins) into .claude/skills/figure-ground-relationship in your project. Claude Code loads it when a task matches its description.

How do I install Figure Ground Relationship in Codex?

Run `npx skills add hashgraph-online/awesome-codex-plugins --skill figure-ground-relationship -a codex`. Or copy the skill folder (plugins/HDeibler/universal-design-principles/plugins/perception-and-hierarchy-principles/skills/figure-ground-relationship in hashgraph-online/awesome-codex-plugins) into .agents/skills/figure-ground-relationship in your project. Codex loads it when a task matches its description.

Can I use Figure Ground Relationship in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add hashgraph-online/awesome-codex-plugins --skill figure-ground-relationship -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/figure-ground-relationship, .gemini/skills/figure-ground-relationship, .github/skills/figure-ground-relationship and .opencode/skills/figure-ground-relationship in your project.

What does Figure Ground Relationship need to run?

SKILL.md names no scripts, command-line tools or credentials: Figure Ground Relationship is instructions for the agent only.

Does Figure Ground Relationship access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Figure Ground Relationship safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Figure Ground Relationship use?

Figure Ground Relationship is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Figure Ground Relationship use?

About 2.2k tokens (SKILL.md is roughly 8.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 1.7k tokens, read only when the agent opens those files.

What are the alternatives to Figure Ground Relationship?

Skills that share tags, products or a category with Figure Ground Relationship: Law Of Figure Ground (Owl-Listener/designer-skills, 2.9k stars), Figure (vectorize-io/hindsight, 47k stars), Principle Separate Before Serializing Shared State (cursor/plugins, 10k stars) and Principle Redesign From First Principles (cursor/plugins, 10k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Figure Ground Relationship?

hashgraph-online (a GitHub organization) maintains it in hashgraph-online/awesome-codex-plugins, which has 1,255 GitHub stars. The repository holds 714 skills in this directory. The repository was last updated on October 9, 2026.

Source: hashgraph-online/awesome-codex-plugins on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.