Marketing

internal-link-optimizer

whyashthakker/agent-skills-marketing · updated Apr 9, 2026

$npx skills add https://github.com/whyashthakker/agent-skills-marketing --skill internal-link-optimizer
summary

### Internal Link Optimizer

  • Analyzes sitemaps to identify target pages, orphan content, and opportunities to strengthen topic authority through contextual linking.
  • Recommends specific source pages, descriptive anchor text, and optimal link placement to improve site navigation and SEO performance.
  • Prioritizes semantically relevant connections over generic links to ensure a natural, user-focused internal linking architecture.
skill.md

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.