site-architecture

Plan site architecture with ASCII hierarchy, Mermaid sitemap, and URL map.

Updated Feb 9, 2026
One-click install
npx skills add https://github.com/tradertunante/servicecontrol --skill site-architecture-tradertunante
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: site-architecture
Source: https://github.com/tradertunante/servicecontrol/tree/main/.agents/skills/site-architecture
Command: npx skills add https://github.com/tradertunante/servicecontrol --skill site-architecture-tradertunante

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Plan and organize website structure — page hierarchy, navigation, URL patterns, and internal linking — to make sites intuitive for users and optimized for search engines.

Core Features & Use Cases

  • 3-click rule driven hierarchy planning for fast access to key pages
  • Visual outputs including ASCII trees and Mermaid diagrams for clear communication
  • URL templates and navigation patterns for common site types (SaaS, content, docs, hybrid)
  • Internal linking strategy (hub-and-spoke, breadcrumbs) and audit guidance to improve crawlability and SEO

Quick Start

Draft the initial site plan by listing primary sections and key pages; then generate an ASCII hierarchy, a Mermaid sitemap, and a URL map.

Frequently Asked Questions about site-architecture

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
What is site architecture and how does it improve SEO and usability?

Site architecture organizes page hierarchy, navigation, and internal linking to make websites intuitive for users and optimized for search engines. Proper planning ensures fast access to key pages and improves bot crawlability through structured URL patterns and clear content relationships.

How do I plan a scalable site structure for a SaaS marketing site?

To plan a scalable site structure, list primary sections and key pages, then generate an ASCII page hierarchy, a Mermaid visual sitemap, and a URL map. This process covers home, product, pricing, blog, resources, integrations, compare pages, and docs using the 3-click rule for fast access.

Can I use this approach to plan internal linking for a documentation portal?

Yes, you can plan internal linking for documentation portals using hub-and-spoke strategies and breadcrumbs. The approach delivers a specific internal-linking plan and audit guidance to improve crawlability and SEO across SaaS marketing sites, content portals, documentation, and hybrid product sites.

What is the best way to visualize a website's information architecture?

The best way to visualize information architecture is generating an ASCII page hierarchy tree alongside a Mermaid visual sitemap. These outputs provide clear communication of URL templates, navigation patterns, and page relationships for common site types like SaaS, content, and docs.

How do I maintain URL structure and navigation as my website evolves?

You maintain URL structure as your site evolves by applying provided contextual templates and guardrails for evolution. The site architecture plan includes a full navigation spec and URL map designed to scale, ensuring your hierarchy remains intact when adding new pages or sections.