
wayfinding-navigation
Design navigation and information architecture for cognitive accessibility. Use when designing or reviewing navigation, site maps, page hierarchies, breadcrumbs, search, multi-step flows, or any structure where users need to find content and know where they are. Triggers on: users get lost, navigation, wayfinding, information architecture, breadcrumbs, findability, site map, confusing structure, where am I.
- Installs
- 77
- Last 24h
- —
- Trending rank
- —
- Security
- Not audited
Install
Works with every agent the skills CLI supports.
npx skills add https://github.com/owl-listener/inclusive-design-skills --skill wayfinding-navigation- 01
Install
Run the command in your project. The CLI asks which agents to install for.
- 02
Describe the task
Ask your agent for something this skill covers. It loads wayfinding-navigation automatically when relevant.
- 03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.
SKILL.md
The instructions your agent reads when the skill is triggered.
Wayfinding and Navigation
Design navigation so that people with cognitive and memory difficulties can find content, understand where they are, and get back to where they were — without relying on memory.
Core Principle
Users should always be able to answer three questions instantly:
- Where am I?
- Where can I go?
- How do I get back?
If any answer requires more than 1 second of thought, the navigation has failed.
Design Patterns
Signpost Pattern
- Breadcrumbs in hierarchies deeper than 2 levels
- Step indicators in multi-step flows ("Step 2 of 4")
- Active section highlighted in navigation
- Page titles that match the link that brought the user here
Minimal Path Pattern
- Important actions reachable in 1–2 clicks from any screen
- Breadth over depth — flatten deep hierarchies
- Shortcuts to frequently used content
- "Back to [last meaningful location]" always available
Multiple Routes Pattern
- Search AND browse AND shortcuts for all important content
- Don't force a single path to any destination
- "Jump to" links for long pages
- Recently visited and frequently used sections accessible
Chunking Pattern
- Break long content into headed sections (3–5 paragraphs each max)
- Table of contents for pages longer than 3 screens
- Progressive disclosure for detail
- Group related form fields into labelled fieldsets
Assessment Checklist
- Every page has a clear, descriptive title
- Navigation is consistent across all pages (same position, same order)
- Current location is always visually indicated
- Breadcrumbs or back links are present in hierarchies
- Multi-step flows show progress and allow backward movement
- Search is available on every page
- Important actions are reachable in 2 clicks or fewer
- Headings describe content (not just categories)
- Link text describes the destination (no "click here")
Output Format
When reviewing: identify navigation failures with specific locations and recommended fixes. When designing: present the information architecture with cognitive accessibility annotations.
FAQ
What does the wayfinding-navigation skill do?
Design navigation and information architecture for cognitive accessibility. Use when designing or reviewing navigation, site maps, page hierarchies, breadcrumbs, search, multi-step flows, or any structure where users need to find content and know where they are. Triggers on: users get lost, navigation, wayfinding, information architecture, breadcrumbs, findability, site map, confusing structure, where am I.
How do I install wayfinding-navigation?
Run npx skills add https://github.com/owl-listener/inclusive-design-skills --skill wayfinding-navigation in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/wayfinding-navigation/ (personal) or .claude/skills/wayfinding-navigation/ (project).
Which AI agents can use wayfinding-navigation?
Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.
Is wayfinding-navigation safe to install?
No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.
Who maintains wayfinding-navigation?
It is published by owl-listener in owl-listener/inclusive-design-skills. It has 77 recorded installs.
More from owl-listener/inclusive-design-skills
plain-language-design
owl-listener/inclusive-design-skills
Open the skill to read its SKILL.md instructions.
keyboard-navigation
owl-listener/inclusive-design-skills
Open the skill to read its SKILL.md instructions.
cognitive-load-assessment
owl-listener/inclusive-design-skills
Open the skill to read its SKILL.md instructions.
responsive-review
owl-listener/inclusive-design-skills
Open the skill to read its SKILL.md instructions.
user-preference-respect
owl-listener/inclusive-design-skills
Open the skill to read its SKILL.md instructions.
error-prevention-recovery
owl-listener/inclusive-design-skills
Open the skill to read its SKILL.md instructions.
Popular code quality & workflow skills
grill-me
mattpocock/skills
A relentless interview to sharpen a plan or design.
improve-codebase-architecture
mattpocock/skills
Scan a codebase for deepening opportunities, present them as a visual HTML report, then grill through whichever one you pick.
handoff
mattpocock/skills
Compact the current conversation into a handoff document for another agent to pick up.
domain-modeling
mattpocock/skills
Build and sharpen a project's domain model. Use when discussing codebase terminology, writing or editing a GLOSSARY.md, or recording or editing an ADR.
codebase-design
mattpocock/skills
Shared vocabulary for designing deep modules. Use when the user wants to design or improve a module's interface, find deepening opportunities, decide where a seam goes, make code more testable or AI-navigable, or when another skill needs the deep-module vocabulary.
diagnosing-bugs
mattpocock/skills
Diagnosis loop for hard bugs and performance regressions. Use when the user says "diagnose"/"debug this", or reports something broken/throwing/failing/slow.