site-architecture

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

Updated Apr 10, 2026
One-click install
npx skills add https://github.com/ramybarsoum/RStack-V0 --skill site-architecture-ramybarsoum
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: site-architecture
Source: https://github.com/ramybarsoum/RStack-V0/tree/main/skill/site-architecture
Command: npx skills add https://github.com/ramybarsoum/RStack-V0 --skill site-architecture-ramybarsoum

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Helps product and design teams plan and restructure website page hierarchies, navigation, URL structure, and internal linking so users can find content easily and search engines can index the site effectively. It clarifies what pages are needed, how they relate, and which URLs must be preserved or redirected during migrations.

Core Features & Use Cases

  • Discovery and context gathering: Guided questions for business goals, audience, current state, site type, content inventory, and redirect needs.
  • Deliverables: ASCII page hierarchy, Mermaid visual sitemap, URL map table, navigation spec (header, footer, sidebar, breadcrumbs), and an internal linking plan including hub-and-spoke recommendations.
  • Use Case: Reorganize a SaaS marketing site to improve findability and preserve SEO equity by mapping old URLs to new ones, designing a flat 2-3 level hierarchy, and producing navigation and linking specs for engineering and content teams.

Quick Start

Create a site architecture plan for a SaaS marketing site including an ASCII hierarchy, Mermaid sitemap, URL map, navigation spec, and internal linking recommendations.

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 site architecture for a new SaaS website?

To plan site architecture for a SaaS website, you organize page hierarchies, navigation, URL structures, and internal linking to ensure content is intuitive for users and indexable by search engines. The process outputs visual sitemaps, URL maps, and navigation specs.

What is the best way to visualize a sitemap and internal linking structure?

The best way to visualize a sitemap and internal linking structure is by generating Mermaid visual sitemaps and ASCII page hierarchies. These formats clearly map page relationships and hub-and-spoke internal linking strategies for engineering and content teams.

How do I map old URLs to new ones during a website migration?

You map old URLs to new ones during a website migration by creating a URL map table that tracks redirect requirements and preserves SEO equity. This involves guided discovery questions about the current site state and business goals.

Can I use this to design navigation specs for e-commerce and documentation sites?

Yes, you can design navigation specs for e-commerce, documentation, SaaS, content, and hybrid websites. It generates detailed specifications for headers, footers, sidebars, and breadcrumbs tailored to the specific site type.

What information do I need before restructuring a website's information architecture?

Before restructuring a website's information architecture, you need to provide business goals, audience details, current site state, content inventory, and redirect needs. Guided discovery questions help collect this context to ensure a flat, SEO-friendly hierarchy.