site-architecture

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

Updated Aug 2, 2026
One-click install
npx skills add https://github.com/Pinkycherry/newbusinessideas3 --skill site-architecture-pinkycherry
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: site-architecture
Source: https://github.com/Pinkycherry/newbusinessideas3/tree/main/.claude/skills/site-architecture
Command: npx skills add https://github.com/Pinkycherry/newbusinessideas3 --skill site-architecture-pinkycherry

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Planning or restructuring a website's information architecture is difficult: pages get buried, navigation becomes cluttered, URLs become inconsistent, and important content ends up orphaned. This Skill provides a structured methodology for designing page hierarchies, navigation systems, URL patterns, and internal linking so sites are intuitive for users and optimized for search engines. ## Core Features & Use Cases - Page Hierarchy Design: Applies the 3-click rule and flat-vs-deep principles to produce ASCII tree structures and Mermaid visual sitemaps for any site type (SaaS, blog, e-commerce, docs, hybrid, small business). - Navigation & URL Planning: Delivers header/footer/sidebar navigation specs, breadcrumb formats, and consistent URL pattern recommendations with redirect guidance for restructures. - Internal Linking Strategy: Builds hub-and-spoke content models, orphan page audits, and cross-section linking plans. - Use Case: A SaaS team adding 200 programmatic integration pages and 50 comparison pages asks how they fit into the site. The Skill recommends hub pages at /integrations and /compare, keeps them out of the main nav, applies hub-and-spoke linking, and addresses crawl budget concerns. ## 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. Group pages into logical parent-child sections, document the result as an ASCII tree, and validate that navigation stays under 4-7 header items.

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

Use short, readable, lowercase paths with hyphens 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 to render page hierarchies with navigation zones as subgraphs. The Skill provides copy-paste templates for basic hierarchies, hub-and-spoke models, before/after restructures, and color-coded page status.

How should programmatic SEO pages fit into site architecture?▼

Place scaled pages under hub pages like /integrations or /compare rather than in the main navigation. Apply hub-and-spoke internal linking where each spoke links back to its hub, and account for crawl budget when adding hundreds of pages.

Does this cover XML sitemaps and crawl errors?▼

No. XML sitemaps, crawl errors, and indexation are technical SEO concerns handled by a dedicated seo-audit skill. This Skill covers design-level architecture: page hierarchy, navigation, URL patterns, and internal linking.

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

Every changed URL needs a 301 redirect to its new location to preserve backlink equity and avoid broken bookmarks. Document the old-to-new mapping as part of the restructure deliverable before launching.