skills.rest
Marshal-Nguyen
Marshal-NguyenCOMMUNITY
Explore all skills by this author →
GitHub

site-architecture

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

1|Updated Aug 17, 2026
Search Tags:#internal linking#information architecture#sitemap#seo#website planning#navigation design#url structure
One-click install
npx skills add https://github.com/Marshal-Nguyen/Skill_Claude_Agent --skill site-architecture-marshal-nguyen
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: site-architecture
Source: https://github.com/Marshal-Nguyen/Skill_Claude_Agent/tree/main/claude/skills/site-architecture
Command: npx skills add https://github.com/Marshal-Nguyen/Skill_Claude_Agent --skill site-architecture-marshal-nguyen

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Websites that grow organically end up with confusing navigation, buried pages, inconsistent URLs, and orphan content that hurts both users and search rankings. This Skill provides a structured methodology for planning or restructuring a site's information architecture so every page has a logical place and clear path. ## Core Features & Use Cases - Page Hierarchy Design: Build ASCII tree sitemaps applying the 3-click rule and flat-vs-deep principles, with ready-made templates for SaaS, blog, e-commerce, docs, hybrid, and small business sites. - Navigation & URL Specification: Define header/footer/sidebar navigation, breadcrumbs, and consistent URL patterns with redirect guidance for restructures. - Internal Linking Strategy: Design hub-and-spoke content models, cross-section links, and orphan page audits, plus Mermaid visual sitemaps for sharing with design teams. - Use Case: A SaaS company adding 200 programmatic integration pages asks how they fit the site. The Skill recommends an /integrations hub page, keeps them out of the main nav, defines URL patterns, and maps the hub-and-spoke linking plan. ## Quick Start Ask the AI 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 sitemap?▼

Start with a content inventory and business goals, then apply the 3-click rule to build a page hierarchy as an ASCII tree. Define URL patterns per page type, design header and footer navigation, and produce a Mermaid visual sitemap for stakeholders.

What is the best URL structure for a SaaS website?▼

Use short, readable, lowercase paths that mirror the hierarchy, such as /features/analytics, /blog/post-slug, and /pricing. 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 limited to 2-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 tasks handled by the seo-audit skill. This skill covers information architecture design: page hierarchy, navigation, URL patterns, and internal linking.

How do I handle URLs when restructuring an existing website?▼

Map every old URL to its new location and implement 301 redirects before launching the new structure. Changing URLs without redirects loses backlink equity and breaks bookmarks and external links.

What is hub-and-spoke internal linking?▼

A hub page covers a broad topic and links to detailed spoke pages, each of which links back to the hub and to related spokes. This model concentrates authority on the hub and ensures no content page becomes orphaned.

Related Skills

Explore More Marketing & Sales Skills→
azeemdigitalazeemdigital

product-marketing-context

Create and update product marketing context documents in .agents/product-marketing-context.md.

Community
Intermediate
lisbeth718lisbeth718
53

pseo-linking

Builds internal linking systems with hub-and-spoke structures, breadcrumbs, and XML sitemaps.

Community
Advanced
NormVgNormVg

technical-seo-checker

Analyze robots.txt, sitemaps, redirects, and schema markup for technical SEO issues.

Community
Advanced
htafollahtafolla
5

seo-programmatic

Automate programmatic SEO planning and analysis for data-driven pages.

Community
Advanced