Agent skill

Wayfinding Physical Spatial Metaphors

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

A skill your agent uses when deciding whether (and how) to borrow physical-world wayfinding metaphors for software — rooms, doors, paths, maps, landmarks.

Apache-2.0Auto-check passed

Install Wayfinding Physical Spatial Metaphors

skills CLI
$ npx skills add hashgraph-online/awesome-codex-plugins --skill wayfinding-physical-spatial-metaphors -a claude-code

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

GitHub CLI
$ gh skill install hashgraph-online/awesome-codex-plugins wayfinding-physical-spatial-metaphors --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/cognition-and-learnability-principles/skills/wayfinding-physical-spatial-metaphors .claude/skills/wayfinding-physical-spatial-metaphors && 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
wayfinding-physical-spatial-metaphors
GitHub stars
1.3k
Token cost
~2.1k tokens
SKILL.md length
1,082 words
Files
2 (incl. references)
Skills in repo
716
Repo updated
First seen
Licence
Apache-2.0

At a glance

A skill your agent uses when deciding whether (and how) to borrow physical-world wayfinding metaphors for software — rooms, doors, paths, maps, landmarks.

  • Works in 3 steps: The user already knows the source. A… → The mapping is consistent. If your… → The user gains something the metaphor…
  • Deciding whether (and how) to borrow physical-world wayfinding metaphors for software — rooms
  • SKILL.md covers When physical metaphors help, When metaphors backfire, Useful spatial metaphors in… and Cross-domain examples, plus 3 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Wayfinding Physical Spatial Metaphors is an agent skill from hashgraph-online/awesome-codex-plugins. Use this skill when deciding whether (and how) to borrow physical-world wayfinding metaphors for software — rooms, doors, paths, maps, landmarks. Trigger when designing app shells with multiple "spaces," when picking metaphors for navigation (workspace, channel, board, project), when reviewing skeuomorphic vs. flat navigation choices, or when the user mentions "feels like a maze" or "where's the front door of this app." Sub-aspect of wayfinding; read that first.

Its SKILL.md is about 2.1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including reference files (for example `references/metaphor-cases.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

  • Deciding whether (and how) to borrow physical-world wayfinding metaphors for software — rooms
  • Designing app shells with multiple spaces
  • Picking metaphors for navigation (workspace
  • Reviewing skeuomorphic vs

Example prompts

  • “spaces,”
  • “feels like a maze”
  • “s the front door of this app.”
  • “/wayfinding-physical-spatial-metaphors”

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

  1. The user already knows the source. A "folder" works because filing cabinets are universal. A "Kanban board" works for users who know…
  2. The mapping is consistent. If your "rooms" can be entered, exited, and have walls, then they should behave like rooms — opening one closes…
  3. The user gains something the metaphor uniquely provides. Spatial metaphors usually provide spatial intuitions: where things are relative…

What it can do on your machine

Read from SKILL.md and the folder at commit 3e1456a. 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

Wayfinding Physical Spatial Metaphors loads about 2.1k tokens when it runs, and up to ~3.8k if it reads all its reference files. Until then it costs about 127 tokens; SKILL.md has 1,082 words of instructions outside code blocks.

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

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 3e1456a, republished under its Apache-2.0 licence (© hashgraph-online). 1,082 words, ~2,081 tokens.

Download SKILL.mdSave it as .claude/skills/wayfinding-physical-spatial-metaphors/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
wayfinding-physical-spatial-metaphors
description
Use this skill when deciding whether (and how) to borrow physical-world wayfinding metaphors for software — rooms, doors, paths, maps, landmarks. Trigger when designing app shells with multiple "spaces," when picking metaphors for navigation (workspace, channel, board, project), when reviewing skeuomorphic vs. flat navigation choices, or when the user mentions "feels like a maze" or "where's the front door of this app." Sub-aspect of `wayfinding`; read that first.

Wayfinding through physical-spatial metaphors

Software navigation borrows from physical-world wayfinding all the time — sometimes deliberately, often by accident. "Folders" mimic filing cabinets; "rooms" and "channels" mimic conference rooms; "boards" and "lists" mimic whiteboards; "drilling down" and "zooming out" are spatial verbs. Used well, these metaphors give users an instant cognitive map. Used carelessly, they create expectations the software can't meet.

When physical metaphors help

The metaphor must satisfy three conditions to be net-positive:

  1. The user already knows the source. A "folder" works because filing cabinets are universal. A "Kanban board" works for users who know Kanban; less for those who don't.
  2. The mapping is consistent. If your "rooms" can be entered, exited, and have walls, then they should behave like rooms — opening one closes the other (or layers it visibly), entering signals a context shift, leaving returns to the previous space.
  3. The user gains something the metaphor uniquely provides. Spatial metaphors usually provide spatial intuitions: where things are relative to each other, what's nearby, what's deeper.

When all three hold, the metaphor offloads cognitive work to the user's existing model.

When metaphors backfire

  • Mismatch between metaphor and behavior. A "Trash" that empties itself silently every 30 days is not a trash — physical trash sits there until you take it out. The metaphor implies one behavior, the system does another, and trust degrades.
  • Forced metaphors that don't fit. Apple's mid-2000s reach for skeuomorphism (leather-bound calendars, felt-textured Game Center) borrowed metaphors that added no informational value and aged poorly.
  • Cross-cultural assumptions. A "front porch" or "lobby" metaphor presumes architectural conventions that don't translate universally.
  • Mixing incompatible metaphors. "Drag this folder into the room you want to share it with" combines a filing-cabinet verb with a building-room metaphor; it works only if the user squints.

Useful spatial metaphors in modern software

Rooms / Channels / Spaces

Slack channels, Discord servers, Notion workspaces, Microsoft Teams. The metaphor: a named container with members and a context. Each room has its own conversations and norms.

Wayfinding implications:

  • Switching rooms feels like changing context (visual transition; current-room highlighted).
  • Entering a room you've never visited shouldn't feel arbitrary — recent activity, who's there, what's pinned should orient you.
  • A "lobby" or "general" channel acts as the entry-room equivalent.
Boards / Lanes / Cards

Trello, Linear, Asana boards. The metaphor: a flat surface (board) with regions (lanes/columns) and movable items (cards). Maps to whiteboards, post-it walls, kanban systems.

Wayfinding implications:

  • The whole board is visible at once — no drilling down required for the primary view.
  • Cards have positions; moving them carries meaning.
  • Zooming out to see "all boards" requires a different metaphor (a folder of boards, a workspace).
Folders / Trees / Hierarchies

The original spatial metaphor: file systems. Folders within folders within folders.

Wayfinding implications:

  • Depth reads as "deeper into" — backwards/up is the universal escape.
  • Tree views show siblings and parents simultaneously; flat folder views show only contents (the file manager pattern).
  • Breadcrumbs make hierarchy navigable without committing to a tree view.

The trap: deep hierarchies are easier to create than to navigate. Wayfinding research consistently finds that 4+ levels of depth become frustrating; users prefer broader, shallower structures.

Maps and Canvases

Figma, Miro, FigJam. The metaphor: an infinite 2D plane that the user pans and zooms across.

Wayfinding implications:

  • Position carries meaning; spatial proximity is grouping.
  • Mini-maps and zoom-to-fit are wayfinding tools borrowed directly from physical maps.
  • Without these tools, users get lost on infinite canvases ("where's the design I made yesterday?").
Stacks / Decks / Stories

Card-stack metaphors (Stories on Instagram, swipeable decks). The metaphor: a stack of cards consumed sequentially.

Wayfinding implications:

  • Position-in-sequence is the orientation (3 of 7).
  • Forward/back are the only navigation verbs; usually no "jump to" without breaking the metaphor.
  • Works well for short sequences; fails for long ones (no random access).

Cross-domain examples

Show full SKILL.md (456 more words)Show less

Museums have used spatial metaphors for centuries: rooms grouped by period, by region, by artist. Visitors orient by which "room" they're in. Modern museum apps mirror this — the audio tour app shows you which room corresponds to your current location, and tapping a room reveals its contents.

The lesson: when the physical space is well-organized, the digital equivalent inherits that organization for free.

City vs. suburban wayfinding

Cities organized on grids (Manhattan, parts of Tokyo) are easier to wayfind than organic-grown cities (Boston, Lisbon, much of London). Grid metaphors translate to software well: a settings page laid out as a grid of categories (Profile, Notifications, Security, Billing) is easier to navigate than one organized by some idiosyncratic logic.

When your IA naturally has a grid-like structure, expose it. When it has an organic structure, lean into landmarks.

"Skeuomorphism revisited"

The flat-design movement (post-2013) rejected literal skeuomorphism (leather-bound calendars, felt poker tables). What survived: spatial intuitions without literal visual mimicry. Sliding panels still feel like opening drawers; cards still feel like tangible objects. The visual style went flat; the spatial metaphors stayed.

The current trend (post-2020) is "neo-skeuomorphism" — subtle depth cues, careful shadows, motion that respects spatial logic. The principle: borrow the physics, not the textures.

Anti-patterns

  • Inventing metaphors no user has ever encountered. "Rendezvous Spaces" or "Wisdom Pods" sound clever in design reviews and confuse everyone in production.
  • Treating containers as both folders and tags. A folder is exclusive (a file lives in one folder); a tag is inclusive (a file can have many tags). Hybrid systems where a "folder" can also be applied as a tag confuse users.
  • The infinite map without a home. Infinite-canvas tools without a "go to my home" or "fit to content" are wayfinding deserts.
  • Animation that contradicts the spatial metaphor. Closing a sheet and having it shrink to a corner unrelated to where it opened from breaks the spatial intuition.

Heuristics

  1. Name the metaphor explicitly. "We're treating these as rooms — that means entering signals a context shift, exiting returns to where you were." Once named, the team can audit consistency.
  2. The "what would the physical version do?" check. When in doubt about a behavior, ask: what would the physical-world equivalent do? Does the software match?
  3. The new-user metaphor test. Onboard a new user without explaining your metaphors. If they intuit "channel," "board," "folder" correctly, the metaphor is doing its work. If they ask "what's a Space?", the metaphor is too clever.
  • wayfinding (parent) — the principle and four-stage framework.
  • wayfinding-search-and-recovery — when spatial metaphors fail, search recovers.
  • wayfinding-breadcrumbs-and-context — making the "where am I" answer load-bearing.
  • mental-model — physical metaphors work because they leverage existing mental models.
  • mimicry — the broader principle of borrowing successful patterns.

© 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/cognition-and-learnability-principles/skills/wayfinding-physical-spatial-metaphors of hashgraph-online/awesome-codex-plugins.

  • SKILL.md
  • references/metaphor-cases.md

Open the folder on GitHubat commit 3e1456a

Compare with similar skills

Wayfinding Physical Spatial Metaphors 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.

Wayfinding Physical Spatial Metaphors compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Wayfinding Physical Spatial Metaphors this skillhashgraph-online/awesome-codex-plugins1.3k—~2.1kAutomated safety check: PassApache-2.0
Bio Spatial Transcriptomics Spatial StatisticsFreedomIntelligence/OpenClaw-Medical-Skills3.1k1 repos~1.8kAutomated safety check: PassNone
Bio Spatial Transcriptomics Spatial NeighborsFreedomIntelligence/OpenClaw-Medical-Skills3.1k1 repos~1.6kAutomated safety check: PassNone
Bio Spatial Transcriptomics Spatial DomainsFreedomIntelligence/OpenClaw-Medical-Skills3.1k1 repos~2.1kAutomated safety check: PassNone
Metaphor AutomationComposioHQ/awesome-claude-skills77k3 repos~734Automated safety check: PassNone
Physical Addressthedaviddias/Front-End-Checklist74k—~574Automated safety check: PassMIT

Similar skills

  • Bio Spatial Transcriptomics Spatial Statistics

    FreedomIntelligence/OpenClaw-Medical-Skills

    Compute spatial statistics for spatial transcriptomics data using Squidpy.

    3.1k GitHub starsUsed in 1 repo~1.8k tokens
    Data & AnalyticsAuto-check passed
  • Bio Spatial Transcriptomics Spatial Neighbors

    FreedomIntelligence/OpenClaw-Medical-Skills

    Build spatial neighbor graphs for spatial transcriptomics data using Squidpy.

    3.1k GitHub starsUsed in 1 repo~1.6k tokens
    Research & ScienceAuto-check passed
  • Bio Spatial Transcriptomics Spatial Domains

    FreedomIntelligence/OpenClaw-Medical-Skills

    Identify spatial domains and tissue regions in spatial transcriptomics data using Squidpy and Scanpy.

    3.1k GitHub starsUsed in 1 repo~2.1k tokens
    Research & ScienceAuto-check passed
  • Metaphor Automation

    ComposioHQ/awesome-claude-skills

    Automate Metaphor tasks via Rube MCP (Composio). An agent skill from ComposioHQ/awesome-claude-skills.

    77k GitHub starsUsed in 3 repos~734 tokens
    Productivity & AutomationAuto-check passed
  • Physical Address

    thedaviddias/Front-End-Checklist

    A skill your agent uses when auditing local business websites, e-commerce sites, or any site where a physical presence affects trust or local search visibility.

    74k GitHub stars~574 tokensUpdated 4 days ago
    Marketing & SEOAuto-check passed

More from hashgraph-online/awesome-codex-plugins

All 716 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 Wayfinding Physical Spatial Metaphors

What does Wayfinding Physical Spatial Metaphors do?

A skill your agent uses when deciding whether (and how) to borrow physical-world wayfinding metaphors for software — rooms, doors, paths, maps, landmarks. Wayfinding Physical Spatial Metaphors is an agent skill from hashgraph-online/awesome-codex-plugins. Use this skill when deciding whether (and how) to borrow physical-world wayfinding metaphors for software — rooms, doors, paths, maps, landmarks.

When should I use Wayfinding Physical Spatial Metaphors?

Wayfinding Physical Spatial Metaphors fits situations like: deciding whether (and how) to borrow physical-world wayfinding metaphors for software — rooms; designing app shells with multiple spaces; picking metaphors for navigation (workspace; reviewing skeuomorphic vs.

How do I install Wayfinding Physical Spatial Metaphors in Claude Code?

Run `npx skills add hashgraph-online/awesome-codex-plugins --skill wayfinding-physical-spatial-metaphors -a claude-code`. Or copy the skill folder (plugins/HDeibler/universal-design-principles/plugins/cognition-and-learnability-principles/skills/wayfinding-physical-spatial-metaphors in hashgraph-online/awesome-codex-plugins) into .claude/skills/wayfinding-physical-spatial-metaphors in your project. Claude Code loads it when a task matches its description.

How do I install Wayfinding Physical Spatial Metaphors in Codex?

Run `npx skills add hashgraph-online/awesome-codex-plugins --skill wayfinding-physical-spatial-metaphors -a codex`. Or copy the skill folder (plugins/HDeibler/universal-design-principles/plugins/cognition-and-learnability-principles/skills/wayfinding-physical-spatial-metaphors in hashgraph-online/awesome-codex-plugins) into .agents/skills/wayfinding-physical-spatial-metaphors in your project. Codex loads it when a task matches its description.

Can I use Wayfinding Physical Spatial Metaphors 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 wayfinding-physical-spatial-metaphors -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/wayfinding-physical-spatial-metaphors, .gemini/skills/wayfinding-physical-spatial-metaphors, .github/skills/wayfinding-physical-spatial-metaphors and .opencode/skills/wayfinding-physical-spatial-metaphors in your project.

What does Wayfinding Physical Spatial Metaphors need to run?

SKILL.md names no scripts, command-line tools or credentials: Wayfinding Physical Spatial Metaphors is instructions for the agent only.

Does Wayfinding Physical Spatial Metaphors 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 Wayfinding Physical Spatial Metaphors 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 Wayfinding Physical Spatial Metaphors use?

Wayfinding Physical Spatial Metaphors 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 Wayfinding Physical Spatial Metaphors use?

About 2.1k tokens (SKILL.md is roughly 8.3k 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 Wayfinding Physical Spatial Metaphors?

Skills that share tags, products or a category with Wayfinding Physical Spatial Metaphors: Bio Spatial Transcriptomics Spatial Statistics (FreedomIntelligence/OpenClaw-Medical-Skills, 3.1k stars), Bio Spatial Transcriptomics Spatial Neighbors (FreedomIntelligence/OpenClaw-Medical-Skills, 3.1k stars), Bio Spatial Transcriptomics Spatial Domains (FreedomIntelligence/OpenClaw-Medical-Skills, 3.1k stars) and Metaphor Automation (ComposioHQ/awesome-claude-skills, 77k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Wayfinding Physical Spatial Metaphors?

hashgraph-online (a GitHub organization) maintains it in hashgraph-online/awesome-codex-plugins, which has 1,267 GitHub stars. The repository holds 716 skills in this directory. The repository was last updated on October 10, 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.