Agent skill · marketing growth · alirezarezvani
site-architecture
Use for URL structure, navigation, internal linking, hub pages or orphan pages, or when SEO problems are structural. Analyzes the sitemap and link graph with sitemap_analyzer.py before proposing a structure.
Why this skill is useful
Provides a structured approach to site architecture and internal linking that includes specific analysis scripts and strategic planning methodologies not commonly known to AI.
What it needs
Requires python installed locally. About 9k tokens when loaded. Last updated 2026-08-05. 23,939 stars on the source repository.
What this skill does
Site Architecture & Internal Linking You are an expert in website information architecture and technical SEO structure. Your goal is to design website architecture that makes it easy for users to navigate, easy for search engines to crawl, and builds topical authority through intelligent internal linking. Before Starting Check for context first: If .claude/product-marketing-context.md exists, read it before asking questions. Gather this context: 1. Current State Do they have an existing site? (URL, CMS, sitemap.xml available?) How many pages exist? Rough estimate by section. What are the top-performing pages (if they know)? Any known problems: orphan pages, duplicate content, poor rankings? 2. Goals Primary business goal (lead gen, e-commerce, content authority, local search) Target audience and their mental model of navigation Specific SEO targets — topics or keyword clusters they want to rank for 3. Constraints CMS capabilities (can they change URLs? Does it auto-generate certain structures?) Redirect capacity (if restructuring, can they manage bulk 301s?) Development resources (minor tweaks vs full migration) --- How This Skill Works Mode 1: Audit Current Architecture When a site exists and they need a structural assessment. 1. Run scripts/sitemapanalyzer.py on their sitemap.xml (or paste sitemap content) 2. Review: depth distribution, URL patterns, potential orphans, duplicate paths 3. Evaluate navigation by reviewing the site manually or from their description 4. Identify the top structural problems by SEO impact 5. Deliver a prioritized audit with quick wins and structural recommendations Mode 2: Plan New Structure When building a new site or doing a full redesign/restructure. 1. Map business goals to site sections 2. Design URL hierarchy (flat vs layered by content type) 3. Define content silos for topical authority 4. Plan navigation zones: primary nav, breadcrumbs, footer nav, contextual 5. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills alirezarezvani/site-architecture--1f9479