skills.rest
aashahin
aashahinCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

site-architecture

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

Updated Jun 22, 2026
Search Tags:#internal linking#information architecture#sitemap#seo#site architecture#navigation design#url structure
One-click install
npx skills add https://github.com/aashahin/ai-skills --skill site-architecture-aashahin
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: site-architecture
Source: https://github.com/aashahin/ai-skills/tree/main/site-architecture
Command: npx skills add https://github.com/aashahin/ai-skills --skill site-architecture-aashahin

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 patterns, and internal linking so sites are intuitive for users and optimized for search engines. ## Core Features & Use Cases - Page Hierarchy Design: Applies the 3-click rule and flat-vs-deep tradeoffs to produce ASCII tree structures and Mermaid visual sitemaps for any site type (SaaS, blog, e-commerce, docs, hybrid, small business). - Navigation & URL Planning: Delivers header/footer/sidebar navigation specs, breadcrumb formats, and consistent URL patterns with redirect guidance for restructures. - Internal Linking Strategy: Builds hub-and-spoke content models, cross-section link plans, and orphan page audits. - Use Case: A SaaS company adding 200 programmatic integration pages asks how they fit into the site. The Skill recommends hub pages at /integrations, keeps them out of the main nav, defines URL patterns, and maps the internal 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, keep the hierarchy as flat as navigation allows, and document the result as an ASCII tree or Mermaid sitemap.

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

Use short, lowercase, hyphenated paths that mirror the hierarchy, such as /features/analytics, /blog/post-slug, and /pricing. Avoid dates, IDs, and query parameters in URLs, pick one trailing slash policy, and keep patterns consistent across sections.

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 contain many pages, group them into dropdowns or mega menus with 2-4 columns rather than adding more top-level items.

Does this skill handle 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 structure, 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 use a hub-and-spoke internal linking model where each spoke links back to its hub. Consider crawl budget impact when adding hundreds of pages.

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 create broken pages for anyone with old links or bookmarks.

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
Let-s-internLet-s-intern
8

seo

Generate SEO metadata, Open Graph, JSON-LD, sitemaps, and canonical URLs for Next.js pages.

Official
Intermediate
NormVgNormVg

technical-seo-checker

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

Community
Advanced
latelierkiyoselatelierkiyose

programmatic-seo

Generate SEO-optimized web pages from templates and dynamic data.

Official
Advanced