# Internal Linking Optimizer > Use when improving internal link structure, anchor text, orphan pages, crawl depth, site architecture, or link equity flow. 内链优化/站内架构 - Skill: `tomevault-io/internal-linking-optimizer` (Agent Skill, multi-file: 2 files) - Install (CLI): `npx skillmds@latest add tomevault-io/internal-linking-optimizer` - Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/internal-linking-optimizer/raw - Safety review: pending - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: Coding & Dev Tools - License: Apache-2.0 - Author: tomevault-io (https://skillmd.com/u/tomevault-io) - Updated: 2026-09-17 - Page: https://skillmd.com/skills/tomevault-io/internal-linking-optimizer --- # Internal Linking Optimizer Analyzes internal link structure, authority flow, orphan pages, anchor text, and topic clusters, then delivers a prioritized linking plan with source/target/anchor recommendations. ## Quick Start Start with one of these prompts, then finish with the standard handoff summary from [Skill Contract](https://github.com/aaron-he-zhu/seo-geo-claude-skills/blob/main/references/skill-contract.md). ```text Analyze internal linking structure for [domain/sitemap] Find internal linking opportunities for [URL] Create internal linking plan for topic cluster about [topic] Suggest internal links for this new article: [content/URL] Find orphan pages on [domain] Optimize anchor text across the site ``` ## Skill Contract **Expected output**: a scored diagnosis, prioritized repair plan, and a short handoff summary ready for `memory/audits/`. - **Reads**: the current page or site state, symptoms, prior audits, and current priorities from [CLAUDE.md](https://github.com/aaron-he-zhu/seo-geo-claude-skills/blob/main/CLAUDE.md) and the shared [State Model](https://github.com/aaron-he-zhu/seo-geo-claude-skills/blob/main/references/state-model.md) when available. - **Writes**: a user-facing audit or optimization plan plus a reusable summary that can be stored under `memory/audits/`. - **Promotes**: blocking defects, repeated weaknesses, and fix priorities to `memory/open-loops.md` and `memory/decisions.md`. - **Next handoff**: use the `Next Best Skill` below when the repair path is clear. ### Handoff Summary > Emit the standard shape from [skill-contract.md §Handoff Summary Format](https://github.com/aaron-he-zhu/seo-geo-claude-skills/blob/main/references/skill-contract.md). ## Data Sources Uses ~~web crawler and ~~analytics when connected; otherwise asks user for sitemap, key page URLs, and content categories. See [CONNECTORS.md](https://github.com/aaron-he-zhu/seo-geo-claude-skills/blob/main/CONNECTORS.md) and [SECURITY.md §Scraping Boundaries](https://github.com/aaron-he-zhu/seo-geo-claude-skills/blob/main/SECURITY.md). ## Instructions When a user requests internal linking optimization: 1. **Analyze Current Structure** -- Capture domain, pages analyzed, total internal links, average links/page, link distribution, top linked pages, under-linked important pages, and a structure score. Flag crawl-depth and authority-flow problems. 2. **Identify Orphan Pages** -- List pages with no inbound internal links. Prioritize high-value orphans with traffic/rankings, medium-potential pages that need category/tag links, and low-value pages to delete, noindex, or redirect. 3. **Analyze Anchor Text Distribution** -- Check current anchor patterns, distribution by page, over-optimization, generic anchors, and CORE-EEAT R08 alignment. > **Reference**: [references/linking-templates.md](https://github.com/aaron-he-zhu/seo-geo-claude-skills/blob/main/optimize/internal-linking-optimizer/references/linking-templates.md) contains the Step 3 output template. 4. **Create Topic Cluster Link Strategy** -- Map pillar/cluster links, recommend structure, and list specific links to add. > **Reference**: [references/linking-templates.md](https://github.com/aaron-he-zhu/seo-geo-claude-skills/blob/main/optimize/internal-linking-optimizer/references/linking-templates.md) contains the Step 4 template. 5. **Find Contextual Link Opportunities** -- For each page, identify topic-relevant source/target/anchor opportunities and prioritize high-impact additions. > **Reference**: [references/linking-templates.md](https://github.com/aaron-he-zhu/seo-geo-claude-skills/blob/main/optimize/internal-linking-optimizer/references/linking-templates.md) contains the Step 5 template. 6. **Optimize Navigation and Footer Links** -- Review main/footer/sidebar/breadcrumb navigation; recommend pages to add, demote, or remove. > **Reference**: [references/linking-templates.md](https://github.com/aaron-he-zhu/seo-geo-claude-skills/blob/main/optimize/internal-linking-optimizer/references/linking-templates.md) contains the Step 6 template. 7. **Generate Implementation Plan** -- Include executive summary, current-state metrics, phased priority actions, implementation guide, and tracking plan. > **Reference**: [references/linking-templates.md](https://github.com/aaron-he-zhu/seo-geo-claude-skills/blob/main/optimize/internal-linking-optimizer/references/linking-templates.md) contains the Step 7 template. ## Example **User**: "Find internal linking opportunities for my blog post on 'email marketing best practices'" **Output**: 5 high-value links with source paragraph, destination URL, recommended anchor text, and priority. Example targets might include list-building, subject-line, segmentation, automation, and tools pages. > **Reference**: See [references/linking-example.md](https://github.com/aaron-he-zhu/seo-geo-claude-skills/blob/main/optimize/internal-linking-optimizer/references/linking-example.md) for the full worked example. ## Tips for Success - Prioritize relevance and user navigation over link volume. - Use descriptive, varied anchors; avoid exact-match repetition. - Link important pages from hubs, navigation, or strong contextual sources. - Audit regularly as content grows. ### Save Results Ask to save results; if yes, write a dated summary to `memory/audits/internal-linking-optimizer/YYYY-MM-DD-.md`. Append veto-level issues to `memory/hot-cache.md` automatically. ## Reference Materials - [Link Architecture Patterns](https://github.com/aaron-he-zhu/seo-geo-claude-skills/blob/main/optimize/internal-linking-optimizer/references/link-architecture-patterns.md) -- Architecture models, selection thresholds, migration safeguards, and measurement targets - [Linking Templates](https://github.com/aaron-he-zhu/seo-geo-claude-skills/blob/main/optimize/internal-linking-optimizer/references/linking-templates.md) -- Detailed output templates for steps 3-7 - [Linking Example](https://github.com/aaron-he-zhu/seo-geo-claude-skills/blob/main/optimize/internal-linking-optimizer/references/linking-example.md) -- Full worked example for internal linking opportunities ## Next Best Skill Primary: [on-page-seo-auditor](https://github.com/aaron-he-zhu/seo-geo-claude-skills/blob/main/optimize/on-page-seo-auditor/SKILL.md) -- verify that revised internal links support page-level goals. --- > Source: [recomby-ai/recomby-geo](https://github.com/recomby-ai/recomby-geo) — distributed by [TomeVault](https://tomevault.io).