internal-linking-optimizer

name	internal-linking-optimizer
description	Use when the user asks to "fix internal linking" or "find orphan pages"; maps link architecture, authority flow, anchor text, and crawl depth, then delivers a prioritized source/target/anchor plan. Not for external backlinks — use seo-backlinks. 内链优化/站内架构
version	9.9.10
license	Apache-2.0
compatibility	Claude Code and compatible agent-skill hosts
homepage	https://github.com/dotusmanali/antigravity-seo
when_to_use	Use when improving internal link structure, anchor text distribution, orphan pages, or site architecture.
argument-hint	<URL or sitemap>
metadata	{"author":"dotusmanali","version":"9.9.10","geo-relevance":"low","tags":["seo","internal-linking","site-architecture","link-equity","orphan-pages","topical-authority","crawl-depth","内链优化","内部リンク","내부링크","enlaces-internos"],"triggers":["improve site architecture","internal linking strategy","link equity flow","pages have no links","site architecture is messy","suggest internal links for this article","fix anchor text distribution","内链优化","孤立页面"]}
id	internal-linking-optimizer
domain	technical
invoked_by	["seo-supervisor"]
depends_on	[]

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.

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: sitemap or page list, key page URLs, content categories, and article/URL to link from.
• Writes: a user-facing linking plan plus a reusable summary that can be stored under memory/audits/.
• Promotes: blocking defects, repeated weaknesses, fix priorities, and pending decisions to memory/open-loops.md.
• Done when: orphan pages are listed with a disposition; anchor distribution is checked against thresholds; a prioritized source/target/anchor plan and handoff summary are produced.
• Primary next skill: 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.

Data Sources

Uses ~~web crawler and ~~analytics when connected; otherwise asks user for sitemap, key page URLs, and content categories. See CONNECTORS.md and SECURITY.md §Scraping Boundaries.

Zero-dependency local helper (no tool needed): python3 scripts/connectors/crawl.py <url> | python3 scripts/connectors/linkgraph.py - computes orphans, click-depth, and internal PageRank from a live crawl. See scripts/connectors/README.md.

Instructions