site-architecture

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

Updated Jun 7, 2026
One-click install
npx skills add https://github.com/agnivon/viral_thread_generator --skill site-architecture-agnivon
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: site-architecture
Source: https://github.com/agnivon/viral_thread_generator/tree/main/.agents/skills/site-architecture
Command: npx skills add https://github.com/agnivon/viral_thread_generator --skill site-architecture-agnivon

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 get buried, navigation becomes cluttered, URLs grow inconsistent, and internal linking is neglected. 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 sitemaps and Mermaid visual sitemaps with navigation zones. - Navigation & URL Standards: Delivers header, footer, sidebar, and breadcrumb specifications plus consistent, human-readable URL patterns for every page type. - Internal Linking Strategy: Builds hub-and-spoke content models, orphan page audits, and cross-section linking plans. - Use Case: A SaaS company adding 200 programmatic integration pages asks how they fit into the site. The Skill recommends hub pages, keeps them out of the main nav, defines URL patterns, and maps the internal linking structure. ## 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. Output an ASCII tree of the full hierarchy, a URL map table, and a navigation specification covering header, footer, and breadcrumbs.

What is the best URL structure for blog posts and feature pages?▼

Use short, lowercase, hyphenated slugs 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 parent 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 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 showing hierarchical page relationships, 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 are technical SEO concerns handled by a dedicated seo-audit skill. This skill covers design-level architecture: page hierarchy, navigation, URL patterns, and internal linking.

How should programmatic SEO pages fit into site architecture?▼

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