site-architecture

Plan, map, and restructure website page hierarchy, navigation, URL structure, and internal linking.

Updated May 28, 2026
One-click install
npx skills add https://github.com/marcosbatallas99/Marketing --skill site-architecture-marcosbatallas99
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: site-architecture
Source: https://github.com/marcosbatallas99/Marketing/tree/main/skills/site-architecture
Command: npx skills add https://github.com/marcosbatallas99/Marketing --skill site-architecture-marcosbatallas99

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill solves the common pain of disorganized website architecture that leads to poor user experience, high bounce rates, low search engine visibility, and difficulty for visitors to find critical content or conversion paths.

Core Features & Use Cases

  • Page Hierarchy Design: Build logical, scalable page structures using the 3-click rule, flat vs deep hierarchy best practices, and ASCII/Mermaid sitemap formats, with pre-built templates for SaaS, e-commerce, content, and documentation sites.
  • Navigation Design: Create optimized header, footer, sidebar, and mobile navigation patterns, including mega menus, breadcrumbs, and contextual links, with rules to avoid decision paralysis and improve cross-device findability.
  • URL Structure Optimization: Implement consistent, human-readable, SEO-friendly URL patterns aligned with site hierarchy, with guidance to avoid common mistakes like over-nesting, dates in URLs, and inconsistent path structures.
  • Internal Linking Strategy: Build hub-and-spoke content models, conduct orphan page audits, and implement cross-section linking to boost SEO authority and user navigation flow.
  • Use Case Example: A SaaS company with 50+ organically grown, disorganized pages can use this Skill to reorganize their site into a logical 3-level hierarchy, reduce header navigation items from 12 to 6, and implement a hub-and-spoke model for their blog and integration pages to improve both user experience and organic search performance.

Quick Start

Use the site-architecture skill to create a complete site architecture plan for our new SaaS marketing website, including a page hierarchy ASCII tree, Mermaid visual sitemap, URL map table, navigation specification, and internal linking strategy.

Frequently Asked Questions about site-architecture

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

FAQPage Schema
How do I design a website structure that improves SEO and user findability?

Design website structure by mapping a logical page hierarchy, flat URL paths, and hub-and-spoke internal linking. This resolves poor findability and low search visibility by ensuring content is reachable within three clicks and aligned with SEO best practices.

What is the best way to create an SEO-friendly URL structure for a new SaaS site?

Create an SEO-friendly URL structure by implementing consistent, human-readable paths that mirror your site hierarchy. Avoid over-nesting, dates, and inconsistent path structures to ensure your SaaS site remains scalable and easily crawlable by search engines.

How do I plan internal linking to boost SEO authority across my content?

Plan internal linking by building hub-and-spoke content models, conducting orphan page audits, and implementing cross-section links. This boosts SEO authority and improves user navigation flow by connecting related topical pages.

Can I use this site architecture approach for both e-commerce and documentation sites?

Yes, you can apply site architecture planning to e-commerce, documentation, SaaS, hybrid, and small business sites. The process generates standardized deliverables like ASCII page hierarchies and Mermaid visual sitemaps tailored to each site type's specific needs.

Why does my current website navigation cause high bounce rates and decision paralysis?

Website navigation causes high bounce rates and decision paralysis when it lacks logical hierarchy and contains too many header items. Reducing header navigation items and implementing clear breadcrumbs improves cross-device findability and user experience.

How do I map a programmatic SEO page integration into my existing site hierarchy?

Map programmatic SEO pages by integrating them into your existing hierarchy using flat structures and consistent URL patterns. The architecture planning process outputs URL map tables and visual sitemaps to seamlessly scale your site without breaking navigation flow.