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.