Individual skill
wayfinding
Use this skill whenever a user must navigate within a non-trivial space — a multi-page web app, a documentation site, a hierarchical settings panel, a conference site, a multi-step flow, a campus, a building, an app with deep IA. Trigger when the user asks how navigation should be structured, when users get lost, when "I can't find X" complaints recur, when designing breadcrumbs, sitemaps, search, or recovery flows. Wayfinding is one of the foundational principles in 'Universal Principles of Design' (Lidwell, Holden, Butler 2003); it's also the only principle from that source not previously covered by these plugins. Routes to sub-aspect skills for spatial metaphors, search-and-recovery, and breadcrumbs.
plugins/HDeibler/universal-design-principles/plugins/cognition-and-learnability-principles/skills/wayfinding/SKILL.md
Source commit d780783eba4ecc7c8b9429f95c9362df95f07c61
What was checked
- Matches the observed repository HEAD
- Yes
- Scanner rules are current
- Yes
- Repository scan complete
- No
- Skill scan complete
- No
- Observed behavior
- Network or broad shell
- Last checked
- Nov 4, 2026
These are observations at the recorded commit, not a guarantee of safety. Review the source before running it.
Install this skill
Choose an agent in your Stack or copy a command below. Commands fetch the pinned commit and copy only this skill directory. Existing destinations are refused. Copying a command does not install anything.
An install command is unavailable: current rules, complete repository and skill scans, an eligible behavior level and a permitted license are required.
Repository context
- Repository stars (not skill ratings)
- 1,532
- Repository last updated
- Nov 6, 2026
- License
- Apache-2.0
Observed agent integration: No specific integration evidence. Standard SKILL.md installation does not imply verified compatibility.
- ai-coding Repository topic
- awesome Repository topic
- awesome-list Repository topic
- codex Repository topic
- codex-plugins Repository topic
- openai Repository topic
- codex-skill Repository topic
- codex-skills Repository topic
- marketplace Repository topic
- codex-marketplace Repository topic
- design Derived category
- docs Derived category
Files and excerpt
File metadata and permitted, redacted excerpts come from the recorded scan. Source links are pinned to that commit.
Browse files
SKILL.mdcore · 16,938 bytesSKILL.mdcore · 16,938 bytesreferences/research-and-cross-domain.mddoc · 9,906 bytes
Read excerpt
# Wayfinding
Wayfinding is the process by which people use spatial and environmental information to orient themselves, choose a path, monitor their progress along it, and recognize when they've arrived. It originated as an architectural and urban-design concept — how people find their way through buildings, campuses, cities — and translates almost directly to information architecture and navigation design in software.
## Definition (in our own words)
Whenever a user must move from where they are now to where they want to be — across rooms in a building, across pages in a web app, across screens in a multi-step flow — they perform a sequence of cognitive operations: figuring out where they are, deciding which way to go, checking that they're still on the right path, and recognizing the destination when it appears. Designs that make any of these four operations harder than necessary produce the universal symptom: users get lost, double back, give up, or call support.
## Origins and research lineage
- **Kevin Lynch**, *The Image of the City* (MIT Press, 1960). The foundational text. Lynch interviewed residents of Boston, Jersey City, and Los Angeles about how they navigated their cities, and identified five elements of the cognitive map: **paths, edges, districts, nodes, and landmarks**. These five categories still organize the field.
- **Romedi Passini**, *Wayfinding in Architecture* (1984) and *Wayfinding: People, Signs, and Architecture* (with Paul Arthur, 1992). Translated Lynch's urban concepts into architectural design, particularly for hospitals, airports, and other complex public buildings where wayfinding failure is consequential.
- **Roger Downs and David Stea**, *Cognitive Maps and Spatial Behavior* (1973), and the broader cognitive-mapping research tradition in environmental psychology.
- **Lidwell, Holden & Butler**, *Universal Principles of Design* (2003), articulated the four-stage model (orientation, route decision, route monitoring, destination recognition) that is the most-cited contemporary summary in design education.