site-architecture

Plan website hierarchy, navigation, and URL schemes with ASCII and Mermaid sitemaps.

2|Updated Mar 20, 2026
One-click install
npx skills add https://github.com/multiplex-ai/muggle-ai-teams --skill site-architecture-multiplex-ai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: site-architecture
Source: https://github.com/multiplex-ai/muggle-ai-teams/tree/main/skills/site-architecture
Command: npx skills add https://github.com/multiplex-ai/muggle-ai-teams --skill site-architecture-multiplex-ai

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

You are an information architecture expert. Your goal is to help plan website structure - page hierarchy, navigation, URL patterns, and internal linking - so the site is intuitive for users and optimized for search engines.

Core Features & Use Cases

  • Define and optimize page hierarchies, navigation schemas, and URL structures for SaaS, content, docs, and hybrid sites.
  • Create breadcrumbs, internal linking strategies, and hub-and-spoke models to improve discoverability and user flow.
  • Produce ASCII tree and Mermaid visual sitemaps to communicate structure to design and engineering teams.

Quick Start

Describe your site goals and I will generate an ASCII hierarchy and Mermaid sitemap to kick off planning.

Frequently Asked Questions about site-architecture

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

FAQPage Schema
What is the 3-click depth rule for website structure planning?

The 3-click depth rule ensures any page on your site is reachable within three clicks from the homepage, keeping your website structure flat and intuitive. This approach improves user navigation and search engine crawlability across SaaS, content, and docs sites.

How do I create a visual sitemap with Mermaid for information architecture?

You can create a visual sitemap with Mermaid by mapping your page hierarchy and hub-and-spoke internal linking patterns into a flowchart. This visualizes your information architecture, making it easier to communicate navigation models to design and engineering teams.

What is the best way to design a URL structure for a SaaS or hybrid site?

The best way to design a URL structure is to align it with your page hierarchy, applying flat versus deep hierarchy principles. This delivers a concise URL map that reflects your site architecture, improving both user discoverability and search engine optimization.

How do hub-and-spoke internal linking patterns improve site navigation?

Hub-and-spoke internal linking patterns connect a primary hub page to related spoke pages, centralizing topical authority and improving user flow. This model enhances site navigation by grouping related content, which helps users and search engines discover pages efficiently.

Can I generate an ASCII tree to document my website hierarchy?

Yes, you can generate an ASCII tree to document your website hierarchy. It provides a clear, text-based representation of your page structure, navigation model, and URL scheme, making it easy to share and edit within version control or plain text documentation.