site-architecture

Plans website page hierarchies, navigation, URL structures, and internal linking strategies.

Updated May 11, 2026
One-click install
npx skills add https://github.com/cloudofgeorge/AI-hands-Engineer --skill site-architecture-cloudofgeorge
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: site-architecture
Source: https://github.com/cloudofgeorge/AI-hands-Engineer/tree/main/skills/marketing/skills/site-architecture
Command: npx skills add https://github.com/cloudofgeorge/AI-hands-Engineer --skill site-architecture-cloudofgeorge

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Planning or restructuring a website's information architecture is hard to do systematically — pages end up buried, navigation becomes cluttered, URLs are inconsistent, and internal linking is an afterthought. This Skill provides a structured methodology for designing page hierarchies, navigation systems, URL patterns, and internal linking plans that work for both users and search engines. ## Core Features & Use Cases - Page Hierarchy Design: Apply the 3-click rule and flat-vs-deep tradeoffs to produce ASCII tree sitemaps and Mermaid visual sitemaps with navigation zones. - URL Structure Standards: Get consistent, human-readable URL patterns for every page type (features, blog, docs, comparisons, integrations) with redirect guidance for restructures. - Navigation & Internal Linking Specs: Design header, footer, sidebar, and breadcrumb navigation plus hub-and-spoke internal linking plans with orphan page audits. - Use Case: A SaaS company adding 200 programmatic integration pages and 50 comparison pages asks how they fit into the site. The Skill recommends hub pages, URL patterns, nav placement, and crawl budget considerations, delivering a full architecture plan. ## Quick Start Ask the agent to plan the site architecture for your website, describing your site type, main sections, and whether it is a new build or a restructure.

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 site structure and page hierarchy?▼

Start with a content inventory and business goals, then apply the 3-click rule so important pages sit within three levels of the homepage. Group pages into logical parent-child sections, keep the hierarchy as flat as navigation allows, and document the result as an ASCII tree or Mermaid sitemap.

What URL structure should I use for blog posts and feature pages?▼

Use short, lowercase, hyphenated slugs that mirror the hierarchy, such as /blog/post-title and /features/feature-name. Avoid dates, IDs, query parameters, and deep nesting, and keep one consistent pattern per section.

How many items should a website header navigation have?▼

Keep the primary header navigation to 4-7 items with the CTA button rightmost. If sections grow beyond that, group pages into dropdowns or mega menus with at most 3-4 columns rather than adding more top-level items.

Does this skill fix XML sitemaps and crawl errors?▼

No. XML sitemaps, crawl errors, and indexation are technical SEO concerns handled by the seo-audit skill. This skill covers information architecture design: page hierarchy, navigation, URL patterns, and internal linking.

How should programmatic SEO pages fit into site architecture?▼

Place them under hub pages such as /integrations or /compare, keep them out of the main navigation, and connect them with hub-and-spoke internal linking. For large volumes of new pages, also account for crawl budget implications.

What happens to old URLs when restructuring a website?▼

Every changed URL needs a 301 redirect to its new location. Without redirects you lose backlink equity and break bookmarks and external links pointing to the old addresses.