site-architecture

---
name: site-architecture
description: Use when planning SEO-friendly site architecture, navigation, internal links, and page hierarchy so the agent follows the marketingskills playbook instead of producing generic marketing advice.
source: https://github.com/coreyhaines31/marketingskills/tree/main/skills/site-architecture
generated: 2026-06-29T18:01:51.417Z
category: concept
audience: marketing
---

## When to use

- The user asks for help planning SEO-friendly site architecture, navigation, internal links, and page hierarchy
- A marketing task needs product, audience, positioning, and channel context before execution
- The agent should create a repeatable site architecture workflow instead of a one-off generic answer
- The work needs clear success metrics, deliverables, and next steps for a growth or GTM motion

## Key concepts

### 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.

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

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

## API reference

```
npx skills add coreyhaines31/marketingskills --skill site-architecture
```

Install the site-architecture skill from coreyhaines31/marketingskills.

```
npx skills add coreyhaines31/marketingskills --skill site-architecture
```

## Gotchas

- Do not add pages only because keywords exist; each page needs a distinct search intent and conversion path.
- Internal links should reflect hierarchy and user journeys, not just distribute PageRank mechanically.
- Read product-marketing context first when present; otherwise the agent may ask repeated setup questions or make weak positioning assumptions.
- Do not ship generic best practices without tying recommendations to the product, audience, channel, and conversion goal.
- Separate strategy from execution: clarify the campaign decision before drafting assets or implementation steps.

---
Generated by SkillMake from https://github.com/coreyhaines31/marketingskills/tree/main/skills/site-architecture on 2026-06-29T18:01:51.417Z.
Verify against source before relying on details.

File: ~/.claude/skills/site-architecture/SKILL.md