wayfinding-physical-spatial-metaphors

Evaluates UI navigation metaphors for clarity and consistency across designs.

6|3|Updated May 3, 2026
One-click install
npx skills add https://github.com/HDeibler/universal-design-principles --skill wayfinding-physical-spatial-metaphors
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: wayfinding-physical-spatial-metaphors
Source: https://github.com/HDeibler/universal-design-principles/tree/main/plugins/cognition-and-learnability-principles/skills/wayfinding-physical-spatial-metaphors
Command: npx skills add https://github.com/HDeibler/universal-design-principles --skill wayfinding-physical-spatial-metaphors

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Prevents design mistakes that happen when software borrows physical-space navigation metaphors (rooms, doors, paths, maps) but maps their behaviors inconsistently, causing users to feel lost or mistrust the interface.

Core Features & Use Cases

  • Metaphor selection validation: Apply a three-condition test (user familiarity, behavioral consistency, and unique cognitive value) to decide whether a physical metaphor will actually help.
  • Backfire diagnosis: Identify common failure modes such as metaphor/behavior mismatch, forced metaphors, cross-cultural assumptions, and mixing incompatible metaphor systems.
  • Practical metaphor guidance: Evaluate fit and implications for common spatial patterns (rooms/channels/spaces, boards/lanes/cards, folders/trees/hierarchies, maps/canvases, stacks/decks/stories) including anti-patterns and heuristics.
  • Design review readiness: Use the provided heuristics to audit naming, validate behavior against physical-world expectations, and run a new-user metaphor test.
  • Related context: Links the sub-skill to the broader wayfinding framework and neighboring sub-skills like search/recovery and breadcrumbs/context.

Quick Start

Use the wayfinding-physical-spatial-metaphors skill to review an app shell and navigation metaphors by asking which metaphor (rooms, boards, folders, maps, stacks) best matches the user’s mental model and whether entry/exit behaviors stay consistent.

Frequently Asked Questions about wayfinding-physical-spatial-metaphors

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I choose the right navigation metaphors for my app's UI?

Selecting navigation metaphors requires checking user familiarity, enforcing consistent behavior-to-metaphor mapping, and ensuring the metaphor provides unique spatial intuition to prevent users from feeling lost.

Why do users feel lost in my app even with spatial UI metaphors like rooms and boards?

Users feel lost when spatial UI metaphors suffer from behavior mismatch, forced over-specific mappings, or incompatible metaphor mixing, which breaks their mental model and trust in the interface.

When should I use skeuomorphism vs flat design for wayfinding?

Use skeuomorphism over flat design when the physical-world metaphor provides unique spatial intuition and user familiarity outweighs the risks of forced metaphors or cross-cultural assumption failures.

How do I audit my app's information architecture for metaphor anti-patterns?

Audit information architecture by applying heuristics to check naming consistency, validate UI behavior against physical-world expectations, and run new-user metaphor tests to identify mismatched or forced patterns.

What are common anti-patterns when mixing physical-world navigation metaphors?

Common anti-patterns include metaphor and behavior mismatch, forcing over-specific metaphors, relying on cross-cultural assumptions, and mixing incompatible metaphor systems like folders and canvases together.