aaron-he-zhu/aaron-marketing-skills / seo-geo/tune/site-structure-optimizer
site-structure-optimizer
VerifiedUse 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. 网站架构/信息架构/站点地图/内链优化
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 15.4 KB |
| references/link-architecture-patterns.md | markdown | 7.8 KB |
| references/linking-example.md | markdown | 2.7 KB |
| references/linking-templates.md | markdown | 4.3 KB |
| references/mermaid-templates.md | markdown | 3.1 KB |
| references/site-type-patterns.md | markdown | 3.5 KB |
references/linking-example.md
View on GitHub# Linking Example — worked before/after
One worked internal-linking example for a small blog, referenced from the Example section of [SKILL.md](../SKILL.md). All numbers are **Estimated** and illustrative.
## Setup
A 6-page email-marketing blog. New post: **"Email marketing best practices"** (the pillar). Existing spokes: list-building, subject-lines, segmentation, automation, tools. One legacy page (old-promo) sits with no inbound links.
## Before — link graph
```mermaid
graph TD
subgraph Site
H[Home] --> B[Best practices pillar]
H --> LB[List building]
H --> SL[Subject lines]
end
subgraph Orphans
SEG[Segmentation]
AUT[Automation]
TL[Tools]
OP[Old promo]
end
```
Diagnosis (Estimated):
- Pages analyzed: 8 · total internal links: 6 · avg links/page: 0.75 (below hub-spoke target 3–10) → −10
- Orphans: 4 (segmentation, automation, tools, old-promo) → −40
- Pillar has no spoke cross-links; segmentation/automation/tools unreachable
- **Structure score: ~50/100** (100 −10 −40, then floored inputs)
## Contextual Link Plan (Step 5 output)
| # | Source paragraph in pillar | Target | Suggested anchor | Priority |
|---|----------------------------|--------|------------------|----------|
| 1 | "Grow a permission-based list…" | /list-building | building an email list | High |
| 2 | "Write subject lines that earn opens…" | /subject-lines | writing subject lines | High |
| 3 | "Send the right message to the right group…" | /segmentation | audience segmentation | High |
| 4 | "Trigger sequences automatically…" | /automation | email automation | High |
| 5 | "Pick a platform that fits…" | /tools | email marketing tools | Medium |
Each spoke adds one link back to the pillar (spoke → hub). Old-promo has no traffic value → default disposition: 301 to the pillar (see SKILL.md Decision Gate).
## After — link graph
```mermaid
graph TD
subgraph Pillars
H[Home] --> B[Best practices pillar]
end
subgraph Cluster
B --> LB[List building]
B --> SL[Subject lines]
B --> SEG[Segmentation]
B --> AUT[Automation]
B --> TL[Tools]
LB --> B
SL --> B
SEG --> B
AUT --> B
TL --> B
end
OP[Old promo] -.301.-> B
```
After (Estimated):
- avg links/page: ~2.9 (approaching hub-spoke target) · orphans: 0 · every spoke ≤2 clicks from home
- Anchor mix: 100% descriptive on the 5 new links (no "click here")
- **Structure score: ~95/100** (residual gap: avg links/page still near the low end)
## Takeaway
Adding 5 descriptive contextual links plus 5 return links converted 4 orphans into a reachable cluster and lifted the pillar's inbound signal — no new content, structure only. Broken-target and migration risks (the old-promo 301) hand off to `content-quality-auditor`.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation). | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK). | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |