proximity-navigation

Apply proximity-based visual grouping to navigation link sets.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill solves the problem of navigation layouts failing to communicate information structure, causing users to treat grouped links as a single undifferentiated list.

Core Features & Use Cases

  • Group structure with spacing: Uses proximity (tight gaps inside groups, looser gaps between groups) to signal hierarchy without heavy chrome.
  • Design navigation patterns across surfaces: Applies proximity rules to sidebars, mobile bottom-nav, breadcrumbs, and command palette groupings.
  • Choose when to add dividers: Recommends light divider usage only when spacing alone cannot carry the grouping clarity.
  • Fix common anti-patterns: Addresses equal-spaced sections, heavy dividers, headings styled as links, and confusing nested-tree indentation.

Quick Start

Use proximity-navigation to redesign your sidebar, bottom nav, or breadcrumbs so related items cluster tightly and separate sections with noticeably larger spacing.

Frequently Asked Questions about proximity-navigation

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

FAQPage Schema
How do I use spacing to visually group navigation links in a sidebar?

To visually group navigation links in a sidebar, apply proximity-based grouping by enforcing tighter intra-group gaps and looser inter-group spacing to signal hierarchy without heavy chrome. This ensures related destinations cluster tightly while separating sections with noticeably larger spacing.

When should I use dividers instead of spacing for UX information architecture?

Use dividers for UX information architecture only when spacing alone cannot preserve grouping clarity. Proximity-based visual grouping is preferred to signal hierarchy, recommending light divider usage solely as a fallback when empty space fails to distinctly separate navigation groups.

What is the best way to fix equal-spaced navigation sections and confusing nested-tree indentation?

The best way to fix equal-spaced navigation sections and confusing nested-tree indentation is to apply proximity-based visual grouping. This approach corrects anti-patterns by tightening intra-group gaps, loosening inter-group spacing, and replacing clickable section headings with non-clickable labels.

Does proximity-based visual grouping work for mobile bottom navigation and breadcrumbs?

Yes, proximity-based visual grouping works for mobile bottom navigation and breadcrumbs. This approach applies proximity rules across multiple surfaces, ensuring link sets read as distinct groups in sidebars, top navigation groupings, breadcrumbs, and command palettes.

Why do users treat my grouped navigation links as a single undifferentiated list?

Users treat grouped navigation links as a single undifferentiated list because the layout fails to communicate information structure. Applying proximity-based visual grouping enforces tighter intra-group gaps and looser inter-group spacing, instantly making navigation groups readable.

Can I apply proximity navigation rules to command palette groupings?

Yes, you can apply proximity navigation rules to command palette groupings. This technique ensures link sets read as distinct groups by enforcing tighter intra-group gaps, looser inter-group spacing, and appropriate non-clickable section headings for clarity.