| 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
