One-click install
npx skills add https://github.com/raphaelmans/agent-skills --skill site-architecture-raphaelmans
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: site-architecture
Source: https://github.com/raphaelmans/agent-skills/tree/main/site-architecture
Command: npx skills add https://github.com/raphaelmans/agent-skills --skill site-architecture-raphaelmans

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Plan and organize a website's pages, navigation, URL structure, and internal linking so users can find information quickly and search engines can index effectively.

Core Features & Use Cases

  • Information architecture planning: define homepage-to-section hierarchy, navigation paths, and page labeling for clarity.
  • URL pattern guidance: design readable, hyphenated URLs that reflect hierarchy and aid SEO.
  • Visual sitemap & navigation design: generate ASCII or Mermaid diagrams and recommended navigation zones to communicate structure.
  • Internal linking strategy: outline hub-and-spoke connections and breadcrumbs to improve crawlability and user flow.

Quick Start

Draft a basic IA plan outlining the homepage, top sections, and an initial URL structure.

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 information architecture that scales for a SaaS marketing site?

Website information architecture planning involves defining a homepage-to-section hierarchy, readable URL patterns, and consistent navigation zones to structure pages like Home, Features, and Pricing. This ensures users find information quickly and search engines index effectively.

What's the best way to design an internal linking strategy and URL structure for a documentation portal?

Design an internal linking strategy by outlining hub-and-spoke connections and implementing breadcrumbs to improve crawlability. For URL structure, use readable, hyphenated patterns that reflect the page hierarchy to aid both user flow and SEO.

How do I create a visual sitemap to communicate website planning and navigation design?

Generate a visual sitemap using ASCII or Mermaid diagrams to outline page hierarchy and recommended navigation zones. This visually communicates the planned site structure, ensuring clear hierarchy and consistent navigation paths for content-heavy blogs.

Can I use this site architecture approach for a content-heavy blog with consistent navigation and breadcrumbs?

Yes, this approach satisfies requirements for clear hierarchy, readable URL patterns, consistent navigation, and breadcrumbs across SaaS marketing sites, documentation portals, and content-heavy blogs to ensure users can navigate pages effectively.

Why does my website planning process need defined URL patterns and page hierarchy?

Defined URL patterns and a clear page hierarchy are needed to ensure readable, hyphenated URLs that reflect site structure, aiding SEO. Without planned site architecture, users struggle to find information and search engines cannot index effectively.