navigation-menu-generator

When the user wants to design, optimize, or audit site navigation menus. Also use when the user mentions "navigation," "nav menu," "header menu," "site structure," "menu design," "navbar," "main menu," "mega menu," "dropdown menu," "mobile menu," or "hamburger menu." For breadcrumbs, use breadcrumb-generator.

313 stars

Best use case

navigation-menu-generator is best used when you need a repeatable AI agent workflow instead of a one-off prompt.

When the user wants to design, optimize, or audit site navigation menus. Also use when the user mentions "navigation," "nav menu," "header menu," "site structure," "menu design," "navbar," "main menu," "mega menu," "dropdown menu," "mobile menu," or "hamburger menu." For breadcrumbs, use breadcrumb-generator.

Teams using navigation-menu-generator should expect a more consistent output, faster repeated execution, less prompt rewriting.

When to use this skill

  • You want a reusable workflow that can be run more than once with consistent structure.

When not to use this skill

  • You only need a quick one-off answer and do not need a reusable workflow.
  • You cannot install or maintain the underlying files, dependencies, or repository context.

Installation

Claude Code / Cursor / Codex

$curl -o ~/.claude/skills/navigation-menu/SKILL.md --create-dirs "https://raw.githubusercontent.com/kostja94/marketing-skills/main/skills/components/navigation/navigation-menu/SKILL.md"

Manual Installation

  1. Download SKILL.md from GitHub
  2. Place it in .claude/skills/navigation-menu/SKILL.md inside your project
  3. Restart your AI agent — it will auto-discover the skill

How navigation-menu-generator Compares

Feature / Agentnavigation-menu-generatorStandard Approach
Platform SupportNot specifiedLimited / Varies
Context Awareness High Baseline
Installation ComplexityUnknownN/A

Frequently Asked Questions

What does this skill do?

When the user wants to design, optimize, or audit site navigation menus. Also use when the user mentions "navigation," "nav menu," "header menu," "site structure," "menu design," "navbar," "main menu," "mega menu," "dropdown menu," "mobile menu," or "hamburger menu." For breadcrumbs, use breadcrumb-generator.

Where can I find the source code?

You can find the source code on GitHub using the link provided at the top of the page.

SKILL.md Source

# Components: Navigation Menu

Guides navigation menu design for SEO, UX, and accessibility. Navigation helps users find content and signals site structure to search engines.

**When invoking**: On **first use**, if helpful, open with 1-2 sentences on what this skill covers and why it matters, then provide the main output. On **subsequent use** or when the user asks to skip, go directly to the main output.

## Initial Assessment

**Check for project context first:** If `.claude/project-context.md` or `.cursor/project-context.md` exists, read it for key pages and audience.

Identify:
1. **Site structure**: Main sections, hierarchy
2. **Primary goals**: Conversion paths, key pages
3. **Platform**: Web, mobile, both

## Structure & Organization

### Menu Size

- **Primary nav**: 7-9 items; avoid overwhelming users
- **Sub-navigation**: Up to 2 levels; deeper topics in sub-menus
- **Pattern**: Horizontal top nav or vertical side nav; avoid novel patterns

### Hierarchy

- Reflect sitemap structure; need not match exactly
- Prioritize what visitors need most
- Logical grouping by topic or task

## SEO Best Practices

| Practice | Purpose |
|----------|---------|
| **Semantic HTML** | `<nav>`, `<ul>`, `<li>`; proper landmark roles |
| **Descriptive anchor text** | Target keywords; avoid "Click here" |
| **Text links** | Prefer text over images; crawlers need readable links |
| **Initial render** | All nav HTML in first paint; no JS-only menus for critical links. See **rendering-strategies** |
| **Visible links** | Prefer visible over hidden; helps crawlers understand structure |

### Crawlability

- Sub-menus: Ensure HTML is in DOM (e.g., CSS-hidden, not JS-injected)
- Footer nav: Include secondary links
- Breadcrumbs: See **breadcrumb-generator** for implementation

## UX Guidelines

### Visibility & Location

- **Desktop**: Visible nav; avoid hiding behind hamburger when space allows
- **Expected placement**: Primary nav in header; footer nav at bottom
- **Current location**: Indicate active page/section in menu

### Accessibility

| Requirement | Practice |
|-------------|----------|
| **Labels** | Clear, intuitive wording |
| **Contrast** | 4.5:1 for link text |
| **Touch targets** | >=44x44px; adequate spacing |
| **Keyboard** | Full keyboard navigation; focus visible |
| **Screen readers** | Proper ARIA; skip links for long menus |

### Design

- Simple, clear; avoid covering entire screen with open menus on desktop
- Consistent across pages
- Mobile: Hamburger acceptable; ensure menu is usable when open

## Output Format

- **Structure** (primary items, sub-items)
- **Anchor text** suggestions
- **HTML/ARIA** notes
- **SEO** checklist
- **Accessibility** checklist

## Related Skills

- **website-structure**: Plan structure and nav hierarchy; nav reflects planned sections
- **xml-sitemap**: Nav should reflect discoverable pages
- **internal-links**: Nav is primary internal linking
- **site-crawlability**: Nav affects crawl paths
- **category-page-generator**: Category hierarchy in nav
- **footer-generator**: Footer nav complements header nav
- **logo-generator**: Logo typically sits in header with nav
- **breadcrumb-generator**: Breadcrumb navigation; BreadcrumbList schema
- **rendering-strategies**: Nav in first paint; no JS-only menus

Related Skills

status-page-generator

313
from kostja94/marketing-skills

When the user wants to create, optimize, or structure a status page. Also use when the user mentions "status page," "status.yourdomain.com," "uptime," "service health," "incident page," or "system status." For incident comms, use public-relations.

signup-login-page-generator

313
from kostja94/marketing-skills

When the user wants to create, optimize, or audit signup and login pages. Also use when the user mentions "signup page," "login page," "registration page," "auth page," "sign up form," "create account," "student discount at signup," or "auth subdomain." For indexing/auth URLs, use indexing.

feedback-page-generator

313
from kostja94/marketing-skills

When the user wants to create, optimize, or audit a feedback or roadmap page. Also use when the user mentions "feedback page," "roadmap," "feature requests," "vote on features," "Canny," "UserVoice," or "product feedback." For sitewide page planning, use website-structure.

disclosure-page-generator

313
from kostja94/marketing-skills

When the user wants to create, optimize, or audit an affiliate, sponsor, or paid partnership disclosure page. Also use when the user mentions "disclosure," "affiliate disclosure," "sponsored content," "FTC disclosure," or "paid partnership." For sitewide page planning, use website-structure.

changelog-page-generator

313
from kostja94/marketing-skills

When the user wants to create, optimize, or structure a changelog or release notes page. Also use when the user mentions "changelog," "release notes," "what's new," "updates," "product updates," "version history," or "changelog.yourdomain.com." For sitewide page planning, use website-structure.

use-cases-page-generator

313
from kostja94/marketing-skills

When the user wants to create, optimize, or audit use case pages. Also use when the user mentions "use cases," "use case page," "for [role]," "by persona," "by scenario," "by business goal," "ICP pages," or "audience-specific pages." For sitewide page planning, use website-structure.

startups-page-generator

313
from kostja94/marketing-skills

When the user wants to create, optimize, or audit a startups, education, or special program page. Also use when the user mentions "startups program," "for startups," "education discount," "student plan," "for students," or "special pricing." For education discounts, use education-program.

solutions-page-generator

313
from kostja94/marketing-skills

When the user wants to create, optimize, or audit solutions pages. Also use when the user mentions "solutions," "solutions page," "by industry," "industry solutions," "by company size," "SMB," "enterprise," "by outcome," "business outcomes," or "how we solve X." For sitewide page planning, use website-structure.

showcase-page-generator

313
from kostja94/marketing-skills

When the user wants to create, optimize, or audit a showcase or gallery page for user-generated content. Also use when the user mentions "showcase," "gallery," "user work," "UGC," "creator showcase," "examples," or "made with [product]." For social proof components, use testimonials-generator.

services-page-generator

313
from kostja94/marketing-skills

When the user wants to create, optimize, or audit a services page. Also use when the user mentions "services page," "what we offer," "service offerings," "consulting services," "service page," "offerings page," "service catalog," or "professional services." For sitewide page planning, use website-structure.

products-page-generator

313
from kostja94/marketing-skills

When the user wants to create, optimize, or audit a product listing or category page. Also use when the user mentions "product page," "product listing," "shop," "e-commerce products," "product catalog," "product grid," "product cards," or "product overview." For category SEO, use category-page-generator.

pricing-page-generator

313
from kostja94/marketing-skills

When the user wants to create, optimize, or audit pricing page content and structure. Also use when the user mentions "pricing page," "pricing table," "plans," "subscription," "pricing plans," "pricing tiers," "pricing comparison," "SaaS pricing," "enterprise pricing," "API pricing," "contact sales," "pricing in nav," "public pricing," "hide pricing," or "pricing objection handling." For pricing strategy, use pricing-strategy.