skills.rest
UnionStreetAI
UnionStreetAIOFFICIAL
Explore all skills by this author →
GitHub

site-architecture

Plan website page hierarchy, navigation, URL structure, and internal linking with ASCII trees and Mermaid sitemaps.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Planning or restructuring a website's information architecture is hard to do systematically: pages get buried, navigation becomes cluttered, URLs grow inconsistent, and internal links are left to chance. This Skill provides a structured method for designing page hierarchies, navigation systems, URL patterns, and internal linking strategies that work for both users and search engines. ## Core Features & Use Cases - Page Hierarchy Design: Apply 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 Specification: Define header nav (4-7 items), footer columns, breadcrumbs, and consistent URL patterns per page type, with redirect guidance for restructures. - Internal Linking Strategy: Build hub-and-spoke content models, audit orphan pages, and plan cross-section links. - Use Case: A SaaS team 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, and defines the linking model. ## Quick Start Ask the agent 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 or sitemap?▼

Start with a content inventory and business goals, then apply the 3-click rule to keep important pages within three levels of the homepage. Produce an ASCII tree of the hierarchy, a Mermaid visual sitemap, a URL map table, and a navigation spec as deliverables.

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

Use short, readable, lowercase hyphenated slugs that reflect the hierarchy, such as /blog/post-slug and /features/feature-name. Avoid dates, IDs, query parameters, and deep nesting, and enforce a consistent trailing-slash policy.

How many items should be in a website header navigation?▼

Keep the primary header nav to 4-7 items with the CTA button rightmost and the logo linking home on the left. If a dropdown exceeds roughly 20 items, add a hierarchy level or use a mega menu with 2-4 columns.

Does this skill fix XML sitemaps or crawl errors?▼

No. XML sitemaps, Search Console crawl errors, and indexation issues are technical SEO tasks handled by the seo-audit skill. Site-architecture covers page hierarchy, navigation, URL design, and internal linking only.

How should programmatic SEO pages fit into site architecture?▼

Place scaled page sets 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 when adding hundreds of pages.

What is the difference between flat and deep site hierarchy?▼

Flat hierarchies (2 levels) suit small sites but do not scale, while deep hierarchies (4+ levels) scale for e-commerce or large docs but risk burying content. Most SaaS and content sites work best at a moderate 3 levels.

Related Skills

Explore More Marketing & Sales Skills→
nicoreincarnate-ossnicoreincarnate-oss

site-architecture

Generates ASCII page hierarchies, Mermaid visual sitemaps, URL maps, nav specs, linking plans, and redirect guidance for websites.

Community
Intermediate
lionheartapplionheartapp

site-architecture

Plan website hierarchies, navigation, URL patterns, and internal linking.

Community
Intermediate
YvesdefariaYvesdefaria

seo

Implements technical and on-page SEO optimizations including meta tags, structured data, and sitemaps.

Community
Intermediate
kostja94kostja94
872

template-page-generator

Design template aggregation and detail pages with calls-to-action.

Community
Intermediate