designing-navigation-systems

Design and audit developer documentation navigation systems with layout and sidebar rules.

Updated Mar 6, 2026
One-click install
npx skills add https://github.com/musher-dev/bundles --skill designing-navigation-systems
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: designing-navigation-systems
Source: https://github.com/musher-dev/bundles/tree/main/developer-docs-authoring/skills/designing-navigation-systems
Command: npx skills add https://github.com/musher-dev/bundles --skill designing-navigation-systems

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill addresses the challenge of creating intuitive and efficient navigation systems for developer documentation, ensuring users can easily find the information they need.

Core Features & Use Cases

  • Layout Design: Defines best practices for three-pane layouts (sidebar, content, TOC).
  • Sidebar Governance: Establishes rules for item limits, grouping, and nesting depth to prevent cognitive overload.
  • Breadcrumb Implementation: Guides the creation of clear, consistent breadcrumb trails.
  • Contextual Navigation: Manages how navigation changes when users switch between different documentation sections.
  • Audit Checklist: Provides a comprehensive checklist for evaluating existing navigation systems.
  • Use Case: You are redesigning a large developer portal and need to ensure the sidebar is organized logically, limiting the number of items per group and nesting depth to improve user experience.

Quick Start

Audit the current navigation system for the 'developer-docs-authoring' repository using the provided checklist.

Frequently Asked Questions about designing-navigation-systems

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

FAQPage Schema
How do I design a developer documentation navigation system that prevents cognitive overload?

Audit sidebar governance by evaluating item count limits, grouping logic, and nesting depth. This skill enforces visual consistency across navigation elements and applies Hick's Law to optimize information architecture for developer documentation.

What is the best way to structure breadcrumbs and contextual navigation for a developer portal?

Structure breadcrumbs and contextual navigation by implementing clear, consistent breadcrumb trails and managing navigation switching between different documentation sections. This ensures users maintain context across large developer portals.

How do I audit an existing documentation sidebar for information architecture discoverability?

Use the provided audit checklist to evaluate existing navigation systems against rules for item count, nesting depth, and visual consistency. This identifies structural issues affecting discoverability and user efficiency in developer documentation.

Does this approach work for large developer portals with complex three-pane layouts?

Yes, this approach works for large developer portals by defining best practices for three-pane layouts including sidebar, content, and table of contents. It manages contextual navigation switching when users move between different documentation sections.

When should I limit nesting depth in a documentation sidebar?

Limit nesting depth in a documentation sidebar when grouping items to prevent cognitive overload and enforce visual consistency. Applying Hick's Law ensures users can process navigation options efficiently without excessive scrolling or confusion.