site-architecture

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

Updated May 13, 2026
One-click install
npx skills add https://github.com/MarcoBolsa/motor-cotacoes --skill site-architecture-marcobolsa
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: site-architecture
Source: https://github.com/MarcoBolsa/motor-cotacoes/tree/main/.claude/skills/marketingskills/site-architecture
Command: npx skills add https://github.com/MarcoBolsa/motor-cotacoes --skill site-architecture-marcobolsa

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Growing websites often end up with disorganized page structures, confusing navigation, and inconsistent URLs that hurt both user experience and SEO. This Skill provides a structured methodology for planning or restructuring a site's information architecture. ## Core Features & Use Cases - Page Hierarchy Design: Builds ASCII tree structures and Mermaid visual sitemaps applying the 3-click rule and flat-vs-deep principles, with templates for SaaS, e-commerce, blog, docs, and small business sites. - Navigation & URL Planning: Defines header/footer/sidebar navigation specs, breadcrumb patterns, and consistent URL conventions for every page type. - Internal Linking Strategy: Implements hub-and-spoke content models, orphan page audits, and cross-section linking plans. - Use Case: A SaaS company adding 200 programmatic integration pages asks how they fit into the site; the Skill recommends hub pages, URL patterns, and linking rules without cluttering the main nav. ## 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. Produce an ASCII tree of the full hierarchy, a URL map table, and a navigation spec with 4-7 header items.

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

Use short, lowercase, hyphenated slugs 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?▼

Generate a Mermaid graph TD diagram showing page relationships, optionally with subgraphs for header and footer navigation zones. Color-coding can mark existing, new, and deprecated pages for restructuring proposals.

Does this skill fix XML sitemaps and crawl errors?▼

No. XML sitemaps, crawl errors, and indexation are technical SEO concerns handled by a separate seo-audit skill. This skill covers design-level architecture: hierarchy, navigation, URLs, 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 connect them with a hub-and-spoke internal linking model. Consider crawl budget when adding hundreds of pages.