recursica-skill-navigation

Enforces house rules for navigation structure, routing, and tabs in enterprise web applications.

1|Updated May 29, 2026
One-click install
npx skills add https://github.com/borderux/recursica-knowledge --skill recursica-skill-navigation-borderux
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: recursica-skill-navigation
Source: https://github.com/borderux/recursica-knowledge/tree/main/skills/design-rules/recursica-skill-navigation
Command: npx skills add https://github.com/borderux/recursica-knowledge --skill recursica-skill-navigation-borderux

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Designing application navigation for complex enterprise web apps often leads to inconsistent decisions — overflowing menus, hover-triggered sub-navs, icon-only rails, modals polluting browser history, and forms split across tabs. This Skill provides opinionated, enforceable house rules so AI assistants and designers make consistent structural choices for sidebars, top bars, breadcrumbs, and tabs. ## Core Features & Use Cases - Routing and history rules: Every navigable view gets a unique URL; modals and panels stay out of browser history unless deliberately deep-linkable; each tab gets its own sub-path. - Navigation structure decisions: Horizontal top bar vs. vertical sidebar based on responsive targets and item-count growth, 7 ± 2 items per level, click-not-hover sub-nav disclosure, and collapsed-by-default groups. - Hard prohibitions and checklists: No icon-only rails, no wrapped or scrolling horizontal nav, no bottom navigation bars, permission-based hiding vs. disabling, and a 28-point pre-flight checklist. - Use Case: When asked to build an app shell with a sidebar, sub-menus, and tabbed detail views, the Skill ensures each tab is a route, sub-nav opens on click, groups load collapsed except the active one, and overflow is fixed structurally rather than with scrollbars. ## Quick Start Review my app shell layout with a sidebar, nested menus, and tabbed detail pages against the Recursica navigation house rules.

Frequently Asked Questions about recursica-skill-navigation

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

FAQPage Schema
How do I choose between a horizontal top bar and vertical sidebar navigation?▼

Decide on two inputs: whether the layout must work below desktop, and how many top-level items exist and whether that count will grow. If item count is expected to grow, prefer a vertical sidebar; otherwise either pattern works.

Should sub-navigation open on hover or click?▼

Sub-navigation must open on click, not hover. Users struggle to control a mouse across hover-revealed menus, and accessible hover sub-navigation is much harder to build correctly. Click either expands the nav in place or navigates to a landing page.

Should modals and panels have their own URL routes?▼

No. Modals and panels are invoked by triggers, not navigated to, so they must not create browser history entries. The single exception is a deliberately deep-linkable modal designed so its URL can be copied and shared.

Can I use an icon-only navigation rail to save space?▼

No. Icon-only primary navigation is prohibited at every viewport width, including mobile and tablet. When space is needed, hide the nav behind a hamburger that opens with both icons and text labels intact.

How many navigation items should each level contain?▼

Target 7 ± 2 items per level, scaled by subject complexity: about 5 for complex subject matter and up to 9 for simple content. Check the effective count per user role after permission-based filtering.

Can I spread a multi-part form across tabs?▼

No. Tabs are for sectioning content, not breaking up data entry; a multi-part form uses a stepper component instead. If forms on tabs are unavoidable, you must prompt the user about unsaved changes on tab switch.