home / Marketing Skills / Site Architecture Skill by @coreyhaines31

Site Architecture Skill by @coreyhaines31

FREE

github stars★ 50,667updatedMay 2026repo@coreyhaines31

activity (commits, last 6 months)

6mo ago0

this month0

$git clone https://github.com/coreyhaines31/marketingskills

The skill is the skills/site-architecture folder inside that repository. Copy it into the folder your agent loads skills from; check your agent's documentation for where that is.

about Site Architecture Skill by @coreyhaines31

Plan, map, or restructure your website's page hierarchy, navigation, URL structure, or internal linking.

Outputs a visual sitemap in Mermaid
Includes an internal linking strategy

our take

Plans page hierarchy, navigation, URL structure and internal linking, after reviewing business context, current state, site type and content inventory.

when to use it

You are restructuring a website
You are planning a sitemap for a new site
You want a clear internal linking plan

before you install

Changing URLs needs redirects to protect rankings
Base structure on what visitors look for, not your org chart

what's inside

The original SKILL.md is organised into these sections:

Before Planning
1. Business Context
2. Current State
3. Site Type
4. Content Inventory
Site Types and Starting Points
Page Hierarchy Design
The 3-Click Rule
Flat vs Deep
Hierarchy Levels
ASCII Tree Format
Navigation Design

source and license

Written and maintained by @coreyhaines31. It is published under the MIT license, which allows reuse with attribution. SkillDirectory does not claim authorship: this page adds our own review and links back to the original, and the skill's text belongs to its author.

View the full SKILL.md on GitHub ↗

Read the opening of the original SKILL.md

# 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)
…

Excerpt only, quoted from the author's repository. Open the repository for the complete file.

↓ download .zip