skill

Site Architecture

When the user wants to plan or restructure a website, or asks which pages they need or where something belongs: hierarchy, navigation, URL structure, internal linking, website builders and migrations. Not XML sitemaps (see seo-audit). For structured data, see schema.

coreyhaines31133,766+ installsVetted

About

# Site Architecture

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.

## Before Planning

**Check for product marketing context first:** If `.agents/product-marketing.md` exists (or `.claude/product-marketing.md`, or the legacy `product-marketing-context.md` filename, in older setups), read it before asking questions. Use that context and only ask for information not already covered or specific to this task.

Gather this context (ask if not provided):

### 1. Business Context - What does the company do? - Who are the primary audiences? - What are the top 3 goals for the site? (conversions, SEO traffic, education, support)

### 2. Current State - New site or restructuring an existing one? - If restructuring: what's broken? (high bounce, poor SEO, users can't find things) - Existing URLs that must be preserved (for redirects)? - What platform is it on, and is a platform change on the table? (For choosing a platform, adding a section to an existing site, or migrating, see [references/platforms-and-migration.md](references/platforms-and-migration.md).)

### 3. Site Type - SaaS marketing site - Content/blog site - E-commerce - Documentation - Hybrid (SaaS + content) - Small business / local

### 4. Content Inventory - How many pages exist or are planned? - What are the most important pages? (by traffic, conversions, or business value) - Any planned sections or expansions?

---

## Site Types and Starting Points

| Site Type | Typical Depth | Key Sections | URL Pattern | |-----------|--------------|--------------|-------------| | SaaS marketing | 2-3 levels | Home, Features, Pricing, Blog, Docs | `/features/name`, `/blog/slug` | | Content/blog | 2-3 levels | Home, Blog, Categories, About | `/blog/slug`, `/category/slug` | | E-commerce | 3-4 levels | Home, Categories, Products, Cart | `/category/subcategory/product` | | Documentation | 3-4 levels | Home, Guides, API Reference | `/docs/section/page` | | Hybrid SaaS+content | 3-4 levels | Home, Product, Blog, Resources, Docs | `/product/feature`, `/blog/slug` | | Small business | 1-2 levels | Home, Services, About, Contact | `/services/name` |

**For full page hierarchy templates**: See [references/site-type-templates.md](references/site-type-templates.md)

---

## Page Hierarchy Design

### The 3-Click Rule

Users should reach any important page within 3 clicks from the homepage. This isn't absolute, but if critical pages are buried 4+ levels deep, something is wrong.

### Flat vs Deep

| Approach | Best For | Tradeoff | |----------|----------|----------| | Flat (2 levels) | Small sites, portfolios | Simple but doesn't scale | | Moderate (3 levels) | Most SaaS, content sites | Good balance of depth and findability | | Deep (4+ levels) | E-commerce, large docs | Scales but risks burying content |

**Rule of thumb**: Go as flat as possible while keeping navigation clean. If a nav dropdown has 20+ items, add a level of hierarchy.

### Hierarchy Levels

| Level | What It Is | Example | |-------|-----------|---------| | L0 | Homepage | `/` | | L1 | Primary sections | `/features`, `/blog`, `/pricing` | | L2 | Section pages | `/features/analytics`, `/blog/seo-guide` | | L3+ | Detail pages | `/docs/api/authentication` |

### ASCII Tree Format

Use this format for page hierarchies:

``` Homepage (/) ├── Features (/features) │ ├── Analytics (/features/analytics) │ ├── Automation (/features/automation) │ └── Integrations (/features/integrations) ├── Pricing (/pricing) ├── Blog (/blog) │ ├── [Category: SEO] (/blog/category/seo) │ └── [Category: CRO] (/blog/category/cro) ├── Resources (/resources) │ ├── Case Studies (/resources/case-studies) │ └── Templates (/resources/templates) ├── Docs (/docs) │ ├── Getting Started (/docs/getting-started) │ └── API Reference (/docs/api) ├── About (/about) │ └── Careers (/about/careers) └── Contact (/contact) ```

**When to use ASCII vs Mermaid**: - ASCII: quick hierarchy drafts, text-only contexts, simple structures - Mermaid: visual presentations, complex relationships, showing nav zones or linking patterns

---

## Navigation Design

### Navigation Types

| Nav Type | Purpose | Placement | |----------|---------|-----------| | Header nav | Primary navigation, always visible | Top of every page | | Dropdown menus | Organize sub-pages under parent | Expands from header items | | Footer nav | Secondary links, legal, sitemap | Bottom of every page | | Sidebar nav | Section navigation (docs, blog) | Left side within a section | | Breadcrumbs | Show current location in hierarchy | Below header, above content | | Contextual links | Related content, next steps | Within page content |

### Header Navigation Rules

- **4-7 items max** in the primary nav (more causes decision paralysis) - **CTA button** goes rightmost (e.g., "Start Free Trial," "Get Started"

Install

Run this command

npx skills add coreyhaines31/marketingskills

Works with

claude appclaude codeclaude apicursorcodexwindsurfclinezed

Manual steps

Install with `npx skills add coreyhaines31/marketingskills`, or clone the repository and copy the `skills/site-architecture` folder into your Claude skills directory.

View source

Frequently asked questions

What is the Site Architecture skill?

When the user wants to plan or restructure a website, or asks which pages they need or where something belongs: hierarchy, navigation, URL structure, internal linking, website builders and migrations. Not XML sitemaps (see seo-audit). For structured data, see schema.

How do I install Site Architecture?

Run this in your terminal:

npx skills add coreyhaines31/marketingskills
Which AI tools does Site Architecture work with?

It works with claude_app, claude_code, claude_api, cursor, codex, windsurf, cline, zed.

Who made Site Architecture?

coreyhaines31.

Is Site Architecture free?

Yes, it is free to use.

Related assets

More curated picks in Marketing & Advertising.

All Site Architecture alternatives →
skillclaude_appclaude_codeclaude_api
npx skills add genmedia-labs/skills
AI Image Generation
Generate and edit images on RunComfy via the `runcomfy` CLI — a smart router across the full image-model catalog: FLUX 2 (Klein 9B/4B, Pro, Dev, Flash…716,844+
skillclaude_appclaude_codeclaude_api
npx skills add heygen-com/hyperframes
Hyperframes Creative
Non-animation creative direction for HyperFrames videos. Use for design spec (frame.md / design.md) handling, palettes, typography, narration, beat pl…690,064+
skillclaude_appclaude_codeclaude_api
npx skills add flowkit-labs/skills
Reddit Automation
Find Reddit threads where people are genuinely asking for what you offer, then draft short, genuinely helpful replies — disclosing your affiliation ho…686,503+
skillclaude_appclaude_codeclaude_api
npx skills add heygen-com/hyperframes
General Video
Author or edit a custom HyperFrames composition when no specialized workflow fits, or when BRIEF.md sets flow: companion. Use for longer or multi-scen…629,562+
skillclaude_appclaude_codeclaude_api
npx skills add heygen-com/hyperframes
Hyperframes Keyframes
Use when a HyperFrames composition needs a punch-in, punch-out, zoom, reframe, Ken Burns treatment, camera move, visual match/whip handoff, or other s…574,917+
skillclaude_appclaude_codeclaude_api
npx skills add 101-skills/superpowers
AI Video Generation
Generate AI videos with Google Veo, Seedance 2.0, HappyHorse, Wan, Grok and 40+ models via inference.sh CLI. Models: Veo 3.1, Veo 3, Seedance 2.0, Hap…553,709+

Audit before you install

Run any source through our checks - AI visibility, security, performance, and stack detection.

More in Marketing & Advertising