npx skills add ...
npx skills add calm-north/seojuice-skills --skill fix-linking
Design or audit internal link structure for a website. Use when the user asks about internal linking, link architecture, orphan pages, PageRank flow, anchor text, site structure, silo architecture, or why pages aren't ranking despite good content. For external link building, see build-links.
npx skills add calm-north/seojuice-skills --skill fix-linking
Design and audit internal link structures using hub-and-spoke topology, PageRank flow logic, and anchor text budgets.
Internal links do two things: (1) pass PageRank between pages, and (2) signal topical relevance via anchor text. A page with zero incoming internal links is an orphan — invisible to authority flow regardless of content quality.
Before auditing links, choose the right architecture model for the site:
| Model | Best For | Site Size | Key Characteristic |
|---|---|---|---|
| Hub-and-Spoke (Topic Cluster) | Content marketing, SaaS, publishers | 50-500 pages | Bidirectional links between pillar and cluster articles |
| Silo Structure | E-commerce, directories, large enterprises | 100+ categories | Vertical-only links within topic silos |
| Flat Architecture | Small sites, portfolios, startups | <100 pages | All pages within 2-3 clicks, cross-linked freely |
| Pyramid | News sites, large blogs, corporate | 500+ pages | Top-down hierarchy, authority concentrates at top |
| Mesh/Matrix | Knowledge bases, wikis, help centers | Any | Free-form linking between any related pages |
| Metric | Hub-and-Spoke | Silo | Flat | Pyramid | Mesh |
|---|---|---|---|---|---|
| Target click depth | ≤3 | ≤4 | ≤2 | ≤4 | ≤3 |
| Internal links per page | 5-10 | 3-7 | 8-15 | 3-5 | 8-15 |
| Cross-section links | Many | Few | N/A | Some | Many |
| Authority distribution | Distributed to hubs | Top of silo | Even | Top-heavy | Even |
| Change | Typical Impact | Timeline |
|---|---|---|
| Fix orphan pages | +15-30% traffic to those pages | 2-4 weeks |
| Build first topic cluster | +10-25% traffic to cluster pages | 4-8 weeks |
| Reduce click depth by 1 level | +5-15% crawl efficiency | 2-6 weeks |
| Anchor text optimization | +5-10% ranking improvement | 4-12 weeks |
| Full architecture migration | +20-50% overall organic traffic | 3-6 months |
Recommended for most sites: Hub-and-Spoke as the primary model, with silo-style isolation between unrelated topic areas.
Before designing links, understand what exists:
Ask the user for their page list or sitemap, or work with what they describe.
For internal links, each page should receive anchor text in this distribution:
| Anchor Type | Target Share | Example |
|---|---|---|
| Exact match | 20-30% | "content decay detection" |
| Partial match | 30-40% | "detecting when content decays" |
| Related/semantic | 20-30% | "pages losing traffic" |
| Branded | 5-10% | "our decay detection feature" |
| Generic | 0-5% | "learn more" |
Diversity improves relevance coverage for semantic search.
For each orphan page, apply this decision tree:
Produce a concrete action plan:
| Source Page | Target Page | Suggested Anchor Text | Where on Source Page | Priority |
|---|---|---|---|---|
| /blog/seo-guide | /tools/keyword-research | "keyword research tool" | Under "Research Phase" heading | high |
| ... | ... | ... | ... | ... |
Priority = high if the target is a revenue-critical or high-intent page.
Current State
Hub-and-Spoke Map For each cluster: Hub → [Spoke 1, Spoke 2, Spoke 3 ...]
Link Injection Plan [Table from Phase 5]
Anchor Text Fixes Pages where anchor text is entirely generic and needs replacement.
Pro Tip: Try the free Internal Link Finder and Anchor Text Diversity tools at seojuice.com. SEOJuice MCP users can run
/seojuice:site-healthfor instant orphan page detection, link depth distribution, and most-linked pages — theget_site_topologytool maps your entire internal link graph automatically.