aiskillstore/marketplace / skills/aaron-he-zhu/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 |
| skill-report.json | config | 59.1 KB |
references/linking-templates.md
View on GitHub# Linking Templates (linking-mode steps 3–7)
Copy-paste output templates for linking mode in [SKILL.md](../SKILL.md). Each template maps to one step. Label every metric **Measured**, **User-provided**, or **Estimated**. Threshold defaults live in [Link Architecture Patterns](link-architecture-patterns.md).
## Anchor & Link Rules (apply throughout)
- **Descriptive over generic**: anchor should describe the target ("email segmentation guide"), not "click here" / "read more".
- **Contextual over navigational**: in-body links inside relevant prose carry more weight than menu/footer links. Count them separately.
- **Link-depth budget**: important pages ≤3 clicks from home; each in-body link ≈ 1 unit of PageRank divided among all links on the page — do not exceed the model's avg-links/page target.
- **One primary target per anchor**: avoid pointing the same exact-match anchor at multiple pages.
- **No redirect chains**: link to the final URL.
> Exact-match anchor guidance tightened: the old 10–20% allowance is retired in favor of **<5% per target** (the stricter current scheme) — repeated exact-match anchors above this read as over-optimization.
## Step 3 — Anchor-Text Distribution
```text
Anchor-Text Distribution — [domain]
Data source: [Measured/Estimated]
| Anchor type | Count | Share | Target | Flag |
|----------------------|-------|-------|---------------|------|
| Descriptive/topical | | % | 60–80% | |
| Branded/navigational | | % | 10–20% | |
| Generic | | % | <10% | |
| Exact-match (repeat) | | % | <5% / target | |
Over-optimized anchors (exact-match > threshold): [list target → anchor → count]
Generic anchors to rewrite: [source → current anchor → suggested descriptive anchor]
Anchor Score /10: [n]
Start 10; −2 if generic >10%; −2 if any exact-match >5% to one target;
−2 if descriptive <60%; −1 per over-optimized cluster (cap −4). Floor 0.
```
## Step 4 — Topic Cluster Link Strategy
```text
Topic Clusters — [domain]
| Pillar (hub) | Spokes (in-cluster) | Missing hub→spoke | Missing spoke→hub | Cross-links to add |
|--------------|---------------------|-------------------|-------------------|--------------------|
| | | | | |
Recommended structure: [hub-spoke / silo / mesh] — see Link Architecture Patterns
Specific links to add: [source → target → anchor → reason]
```
## Step 5 — Contextual Link Opportunities
```text
Contextual Link Plan — [page or domain]
| # | Source page (+paragraph) | Target URL | Suggested anchor | Priority | Target resolves? |
|---|--------------------------|------------|------------------|----------|------------------|
| 1 | | | | High | Yes/No (404→flag)|
Broken targets flagged for content-quality-auditor (R10): [list]
```
## Step 6 — Navigation & Footer Links
```text
Navigation Review — [domain]
| Zone | Current items | Add | Demote | Remove | Reason |
|------------|---------------|-----|--------|--------|--------|
| Header | | | | | |
| Footer | | | | | |
| Sidebar | | | | | |
| Breadcrumb | | | | | |
Header rule: 4–7 items, CTA rightmost, logo → home. Breadcrumbs mirror the URL path.
```
## Step 7 — Implementation Plan
```text
Internal Linking Plan — [domain] | Structure Score: [n]/100
Executive summary: [1–2 lines: biggest structural gap + expected effect]
Current-state metrics (label each Measured/Estimated):
- Pages analyzed / total internal links / avg links per page
- Orphans / under-linked important pages / max click depth
Phased priority actions:
P1 (blocking): [orphans of high-value pages, migrations without 301]
P2 (this sprint): [add contextual links, rewrite generic anchors]
P3 (backlog): [nav/footer tuning, low-value orphan disposition]
Implementation guide: [source → target → anchor, grouped by page]
Tracking plan: re-crawl cadence; metrics to watch (orphan count, avg depth, anchor mix)
Handoff: veto-level risks (migration w/o redirect, broken targets) → 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 |