site-architecture

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

Updated Aug 13, 2026
One-click install
npx skills add https://github.com/imMamdouhaboammar/marketing-skills --skill site-architecture-immamdouhaboammar
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: site-architecture
Source: https://github.com/imMamdouhaboammar/marketing-skills/tree/main/skills/site-architecture
Command: npx skills add https://github.com/imMamdouhaboammar/marketing-skills --skill site-architecture-immamdouhaboammar

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Planning or restructuring a website's information architecture is difficult: pages pile up without clear hierarchy, navigation becomes cluttered, URLs grow inconsistent, and important content gets buried. This Skill provides structured frameworks for designing page hierarchies, navigation systems, URL patterns, and internal linking so sites are intuitive for users and optimized for search engines. ## Core Features & Use Cases - Page Hierarchy Design: Apply the 3-click rule and flat-vs-deep principles to build ASCII tree sitemaps with URL annotations for SaaS, e-commerce, content, documentation, and small business sites. - Navigation & URL Planning: Design header, footer, sidebar, and breadcrumb navigation with concrete rules (4-7 header items, CTA placement), plus consistent URL patterns per page type. - Visual Sitemaps & Internal Linking: Generate Mermaid diagram sitemaps with navigation zones and color coding, and plan hub-and-spoke internal linking 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 at /integrations and /compare, hub-and-spoke linking, and keeping them out of the main nav. ## Quick Start Ask the agent to plan the site architecture for your website, describing your site type, existing pages, and goals, and receive a page hierarchy, 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 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. Build an ASCII tree showing every page with its URL, keeping the structure as flat as possible while navigation stays clean.

What is the best URL structure for SEO?

Use short, lowercase, hyphenated URLs that mirror the site hierarchy, such as /features/analytics or /blog/post-slug. Avoid dates, IDs, query parameters, and deep nesting, and always set up 301 redirects when changing existing URLs.

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 larger, group pages into dropdowns or mega menus limited to 3-4 columns rather than adding more top-level items.

How do I create a visual sitemap to share with a design team?

Use Mermaid graph TD diagrams to show page relationships hierarchically, with subgraphs marking header and footer navigation zones. Color coding can distinguish existing pages, new pages, and pages to remove or redirect.

Does this skill fix XML sitemaps and crawl errors?

No. XML sitemaps, crawl errors, and indexation issues are technical SEO tasks 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?

Create hub pages such as /integrations or /compare that link to all generated pages, and have each page link back to its hub. Keep large programmatic sets out of the main navigation and consider crawl budget when adding hundreds of pages.