site-architecture

Plan website page hierarchies, navigation, URL structures, and internal linking.

Updated Mar 27, 2026
One-click install
npx skills add https://github.com/liammcleod-hub/blog --skill site-architecture-liammcleod-hub
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: site-architecture
Source: https://github.com/liammcleod-hub/blog/tree/main/repo-skills/marketing-library/skills/site-architecture
Command: npx skills add https://github.com/liammcleod-hub/blog --skill site-architecture-liammcleod-hub

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Helps teams and product owners design clear website page hierarchies, navigation, URL patterns, and internal linking so users can find content easily and search engines can index the site effectively. Reduces confusion from messy navigation, prevents orphaned pages, and guides URL and breadcrumb alignment to preserve SEO value during restructures. Distinguishes planning-level architecture from technical SEO tasks like XML sitemaps or crawl error remediation.

Core Features & Use Cases

  • Page Hierarchy Templates: ASCII tree and Mermaid templates for SaaS, content, e-commerce, docs, and hybrid sites to quickly sketch levels and parent-child relationships.
  • Navigation Design: Recommendations for header, footer, sidebar, breadcrumbs, and mobile patterns with rules like 4–7 primary header items and CTA placement.
  • URL Structure & Redirects: Human-readable slug guidance, hyphenation, trailing slash policy, and redirect strategy for moved pages to preserve link equity.
  • Internal Linking Strategy: Hub-and-spoke models, related-content patterns, orphan audits, and link audit checklists to improve discovery and PageRank flow.
  • Use Cases: New site planning, large-site reorganizations (50+ pages), programmatic SEO sections (integrations/comparisons), and designing sitemaps for design/wireframing.

Quick Start

Create a site architecture plan for a SaaS marketing site with homepage, features, pricing, blog, integrations, and programmatic sections that includes an ASCII hierarchy, Mermaid sitemap, URL map, navigation spec, and internal linking plan.

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 site architecture for a new SaaS marketing site?

Plan site architecture by mapping page hierarchies, navigation, URL structures, and internal linking. You can generate ASCII tree hierarchies, Mermaid visual sitemaps, URL maps, and navigation specs to establish clear page organization and scalable navigation for new sites.

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

The best way to structure SEO-friendly URLs and internal links is using human-readable slugs with hyphens and applying hub-and-spoke internal linking models. This approach preserves link equity, prevents orphaned pages, and improves both user findability and search engine indexing.

How do I design website navigation for large sites with 50+ pages?

Design website navigation for large sites by defining header, footer, sidebar, and breadcrumb patterns. Keep 4–7 primary header items, ensure logical parent-child relationships, and audit for orphaned pages to maintain findability across a large-scale reorganization.

Can I generate a visual sitemap using Mermaid for a website restructure?

Yes, you can generate visual sitemaps using Mermaid diagrams to map out page hierarchy and parent-child relationships during a website restructure. This helps teams visualize scalable navigation and align URL structures before implementation.

When do I need a redirect strategy for site architecture changes?

You need a redirect strategy when restructuring existing sites or moving pages to preserve link equity and SEO value. Plan redirects alongside URL structure changes and trailing slash policies to ensure search engines and users find the correct pages.

Does site architecture planning cover XML sitemaps and crawl error remediation?

No, site architecture planning focuses on page hierarchy, navigation, URL patterns, and internal linking rather than technical SEO tasks like XML sitemaps or crawl error remediation. It distinguishes planning-level architecture from technical SEO implementation.