site-architecture

Plan SEO-friendly website hierarchies, navigation, URLs, and internal linking.

Updated Mar 17, 2026
One-click install
npx skills add https://github.com/TomWall1/WageCheck --skill site-architecture-tomwall1
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: site-architecture
Source: https://github.com/TomWall1/WageCheck/tree/main/.agents/skills/site-architecture
Command: npx skills add https://github.com/TomWall1/WageCheck --skill site-architecture-tomwall1

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Provides a structured process for planning page hierarchies, navigation, URLs, and internal linking whenever teams are trying to redesign or expand a website without clarity on how pages should connect, while ensuring product marketing context is captured before next steps.

Core Features & Use Cases

  • Product marketing context first: Always review .agents/product-marketing-context.md (or legacy .claude/...) so follow-up questions stay focused and avoid repeating known information.
  • Hierarchies, navigation, and URLs: Guides the three-click rule, flat vs. deep balance, ASCII/mermaid hierarchy formats, navigation zones, and human-friendly URL patterns for SaaS, content, e-commerce, docs, and hybrid sites.
  • Internal linking and deliverables: Covers navigation specs, URL map tables, hub-and-spoke linking, breadcrumb alignment, and visual sitemap output so every planning engagement ends with a complete architecture plan.

Quick Start

Ask for the product marketing context, then map the homepage, navigation, and URL plan using the site architecture guidance.

Frequently Asked Questions about site-architecture

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

FAQPage Schema
How do I plan a website hierarchy for a new marketing site?

Planning a website hierarchy involves mapping page structures, navigation zones, and URL patterns. This process ensures intuitive user flow and SEO readiness by applying rules like the three-click rule and balancing flat versus deep page depth.

What is the best way to structure URLs for SEO and navigation?

The best way to structure URLs is using human-friendly patterns that reflect your page hierarchy. A clear URL structure aligns with navigation design and internal linking strategies, helping search engines and users understand page relationships.

How does internal linking affect site architecture?

Internal linking connects pages within your site architecture through hub-and-spoke models and breadcrumb alignment. It distributes page authority, reinforces page hierarchy, and guides users logically through related content clusters.

Can I use this site architecture planning process for a content hub restructure?

Yes, this site architecture planning process applies to content hubs, e-commerce stores, and documentation sites. It accommodates hybrid models by mapping specific page types, navigation specs, and internal linking plans for restructures.

What is the three-click rule in navigation design?

The three-click rule in navigation design suggests users should reach any page within three clicks. It guides the balance between flat and deep hierarchies to ensure intuitive access without overwhelming the main navigation menu.

Do I need product marketing context before designing site architecture?

Yes, reviewing product marketing context before designing site architecture ensures follow-up questions remain focused. It captures known product positioning, preventing repetitive planning steps and aligning URL strategy with business goals.