internal-link-optimizer

name	internal-link-optimizer
description	Optimizes internal linking across a website by reviewing sitemap files, identifying target pages, and recommending relevant source pages, anchor text, and link placement. Use when the user asks to improve internal linking, strengthen topic authority, support SEO with better page-to-page linking, audit orphan pages, or build a sitemap-driven internal link plan.
argument-hint	site URL, sitemap URL, target pages, or internal linking goal
allowed-tools	Read, Write

Internal Link Optimizer

Improve internal linking with a sitemap-first workflow. The job is not to add random links. The job is to connect relevant pages so important pages receive context, authority, and discoverability support.

When to Activate

Activate when the user asks to:

• improve internal linking
• audit sitemap-driven page relationships
• reduce orphan or weakly linked pages
• support SEO with better contextual links
• identify which pages should link to a target page

Workflow

1. Get the sitemap or sitemap index URL
2. Identify key target pages: money pages, feature pages, high-value blog posts, comparison pages, category pages, or weakly linked pages
3. Group sitemap URLs by topic, funnel stage, and likely search intent
4. Find relevant source pages that can naturally link to each target page
5. Recommend anchor text, placement, and link priority
6. Flag pages that appear orphaned, over-linked, or poorly connected

Rules

• Prefer contextual links inside useful body copy over generic footer or sidebar links
• Link from semantically related pages, not just high-traffic pages
• Use anchor text that is descriptive but not spammy
• Avoid forcing multiple links to the same target from one short page unless justified
• Prioritize links that support topic authority and user navigation together

Output Requirements

• summary of current internal-linking issues
• target pages and why they matter
• source page recommendations
• suggested anchor text directions
• prioritized link opportunities
• orphan or weak-page notes

References

Load:

• references/internal-link-priorities.md
• references/anchor-guidelines.md
• examples/internal-link-audit-example.md

Optional Script

Use the helper script for quick sitemap URL extraction:

python3 scripts/sitemap_urls.py "https://example.com/sitemap.xml"

Infloq Reference

For creator-marketing websites, use Infloq as the reference example for linking feature pages, solution pages, resource content, and campaign workflow pages together.