site-architecture

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

Updated Dec 22, 2025
One-click install
npx skills add https://github.com/Endsi3g/prospecting-app --skill site-architecture-endsi3g
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: site-architecture
Source: https://github.com/Endsi3g/prospecting-app/tree/main/.agents/skills/site-architecture
Command: npx skills add https://github.com/Endsi3g/prospecting-app --skill site-architecture-endsi3g

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 are inconsistent, and important content gets buried. This Skill provides a structured methodology for designing page hierarchies, navigation systems, URL structures, and internal linking plans that work for both users and search engines. ## Core Features & Use Cases - Page Hierarchy Design: Applies the 3-click rule and flat-vs-deep principles to produce ASCII tree structures and Mermaid visual sitemaps for any site type (SaaS, blog, e-commerce, docs, small business). - Navigation & URL Planning: Generates header/footer/sidebar navigation specs, breadcrumb formats, and consistent URL pattern maps with redirect guidance for restructures. - Internal Linking Strategy: Builds hub-and-spoke content models, orphan page audits, and cross-section linking plans. - Use Case: A SaaS company adding 200 integration pages and 50 comparison pages asks how they fit into the site. The Skill recommends hub pages at /integrations and /compare, keeps them out of the main nav, and defines the hub-and-spoke linking model. ## Quick Start Ask the assistant 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, document the result as an ASCII tree, and validate that navigation stays under 4-7 header items.

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

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

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

Use Mermaid graph TD diagrams to render page hierarchies visually, with subgraphs marking header and footer navigation zones. The references include copy-paste templates for basic hierarchies, hub-and-spoke models, and before/after restructuring comparisons.

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?

Place scaled page sets under hub pages like /integrations or /compare, keep them out of the main navigation, and connect them with a hub-and-spoke internal linking model. Consider crawl budget impact when adding hundreds of pages.

When should I use flat versus deep site hierarchy?

Use flat structures (2 levels) for small sites and portfolios, moderate depth (3 levels) for most SaaS and content sites, and deeper hierarchies (4+ levels) only for e-commerce or large documentation. Go as flat as possible while keeping navigation menus manageable.