
The fix-linking skill helps SEO professionals and website owners design and audit internal link structures using hub-and-spoke topology, PageRank flow analysis, and anchor text optimization to improve site authority distribution and page rankings. It addresses the problem of orphaned pages, inefficient link architecture, and pages that fail to rank despite quality content by providing architecture models (hub-and-spoke, silo, flat, pyramid, mesh) tailored to different site sizes and goals. The skill guides users through mapping current structures, identifying optimization opportunities, and implementing changes that typically yield 15-50% traffic improvements depending on the scope of restructuring.
$ npx -y skills add calm-north/seojuice-skills --skill fix-linking --agent claude-codeInstalls into .claude/skills of the current project.
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.
Sponsors