skills.rest
oxie
oxieCOMMUNITY
Explore all skills by this author →
GitHub

site-architecture

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

Updated Sep 6, 2026
Search Tags:#internal linking#mermaid#information architecture#sitemap#website planning#navigation design#url structure
One-click install
npx skills add https://github.com/oxie/prime-agent-skills --skill site-architecture-oxie
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: site-architecture
Source: https://github.com/oxie/prime-agent-skills/tree/main/marketingskills/skills/site-architecture
Command: npx skills add https://github.com/oxie/prime-agent-skills --skill site-architecture-oxie

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 linking is left to chance. This Skill provides a structured workflow for designing page hierarchies, navigation systems, URL patterns, and internal linking plans that work for both users and search engines. ## Core Features & Use Cases - Page Hierarchy Design: Produces ASCII tree structures and Mermaid visual sitemaps applying the 3-click rule and flat-vs-deep tradeoffs, with templates for SaaS, blog, e-commerce, docs, hybrid, and small business sites. - Navigation & URL Specification: Defines header, footer, sidebar, and breadcrumb navigation with concrete rules (4-7 header items, CTA placement), plus consistent URL patterns per page type and redirect guidance for restructures. - Internal Linking Strategy: Builds hub-and-spoke content models, orphan page audits, and cross-section linking plans, with page-purpose recipes for blogs, portfolios, services, docs, and resource hubs. - Use Case: A SaaS team adding 200 integration pages and 50 comparison pages asks how they fit the site. The Skill recommends hub pages at /integrations and /compare, keeps them out of the main nav, applies hub-and-spoke linking, and delivers a full URL map and navigation spec. ## Quick Start Ask the agent to plan the site architecture for your website, describing your site type, existing or planned pages, 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 your site type, then apply the 3-click rule so important pages stay within three clicks of the homepage. Produce an ASCII tree of the hierarchy, a URL map table, and a navigation spec with 4-7 header items ordered by priority.

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

Use short, readable, lowercase hyphenated paths 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 showing page relationships, with subgraphs for header and footer navigation zones and color coding for new, existing, or removed pages. The references directory includes copy-paste Mermaid templates for hierarchies, hub-and-spoke models, and before/after restructures.

How should programmatic SEO pages fit into site architecture?▼

Place scaled page sets like integrations or comparisons under hub pages such as /integrations and /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.

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.

What should I do with old URLs when restructuring a website?▼

Map every old URL to its new location with a 301 redirect before launching the restructure. Without redirects you lose backlink equity and create broken pages for anyone with old links or bookmarks.

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
B4rz99B4rz99

frontend-design

Generate custom web components, pages, applications, or interfaces with distinctive aesthetics.

Community
Advanced
davila7davila7
30.5k

SEOAgent

Runs technical SEO audits, keyword clustering, content briefs, and article drafts persisted to a .seoagent/ workspace.

Community
Intermediate
Samuelca6399Samuelca6399

programmatic-seo

Design programmatic SEO templates with quality gates and internal linking plans.

Community
Advanced