site-structure-optimizer

name	site-structure-optimizer
slug	site-structure-optimizer
displayName	Site Structure Optimizer · 网站架构
summary	网站架构/信息架构/站点地图/内链优化
description	Use when the user asks to "plan my site structure", "design the page hierarchy / navigation / URL taxonomy", "fix internal linking", or "find orphan pages"; runs two modes — architecture (hierarchy, nav, URL patterns, hub/spoke clusters, Mermaid site maps) and linking (link graph, authority flow, anchor text, orphan disposition, source/target/anchor plan) — and outputs a structure score /100 plus a handoff summary. Not for external backlinks — use offsite-signal-analyzer; not for XML sitemap or indexation issues — use technical-seo-checker. 网站架构/信息架构/站点地图/内链优化
version	17.0.0
license	Apache-2.0
compatibility	Claude Code and compatible agent-skill hosts
homepage	https://github.com/aaron-he-zhu/aaron-marketing-skills
when_to_use	Use when planning or restructuring a site (page hierarchy, navigation, URL taxonomy, hub/spoke topic clusters, visual sitemap) OR when fixing internal link structure (orphan pages, anchor-text distribution, authority flow, crawl depth). One skill, two altitudes: architecture designs the structure; linking optimizes the links inside it.
argument-hint	[--mode architecture|linking] <domain, sitemap, or page list + site type>
metadata	{"author":"aaron-he-zhu","version":"17.0.0","discipline":"seo-geo","phase":"optimize","geo-relevance":"high","hermes":{"tags":["marketing","seo-geo","optimize"],"category":"seo-geo"},"openclaw":{"emoji":"🔍","homepage":"https://github.com/aaron-he-zhu/aaron-marketing-skills"}}

Site Structure Optimizer

Works one lever of site structure at two altitudes. Architecture mode designs the whole-site information architecture — page hierarchy, navigation, URL taxonomy, hub/spoke topic clusters, link topology — and renders Mermaid site maps that make orphans and link islands visible. Linking mode optimizes the links inside an existing structure — link graph, authority flow, anchor text, orphan disposition — and delivers a prioritized source/target/anchor plan. Both emit a structure score /100 and a handoff summary.

Scope guard: this skill does not compute the CORE-EEAT score or run vetoes (T04, C01, R10) — that is the content-quality-auditor gate. It does not analyze external backlinks (offsite-signal-analyzer) or diagnose XML sitemaps / indexation (technical-seo-checker). It works the structure lever and hands off.

Mode Selector

Mode	Altitude	Use when	Core outputs
architecture	Whole-site layout	New build or restructure; the layout itself is the question	ASCII hierarchy tree, URL map table, nav spec, hub/spoke plan, Mermaid site map, architecture score /100
linking	Links inside an existing layout	Pages exist; the question is how they connect	Orphan list + disposition, anchor-text distribution, contextual link plan (source/target/anchor), structure score /100

Pick the mode from --mode if given. Otherwise infer: "plan / design structure / URL taxonomy / hub-spoke / sitemap" → architecture; "fix internal linking / orphan pages / anchor text / authority flow" → linking. If the request spans both (e.g., "restructure the site AND fix the links"), run architecture first, then hand off to linking (see Next Best Skill) — do not silently interleave.

Quick Start

Start with one of these prompts, then finish with the standard handoff summary from Skill Contract.

# architecture mode
Plan the site structure for a new SaaS marketing site
Restructure my existing site — pages feel buried and disorganized
Design the URL taxonomy and navigation for [domain]
Map hub/spoke topic clusters for my blog around [topic]

# linking mode
Analyze internal linking structure for [domain/sitemap]
Find orphan pages on [domain]
Suggest internal links for this new article: [content/URL]
Optimize anchor text across the site