| 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 backlink-analyzer. 内链优化/站内架构 |
| version | 9.9.12 |
| license | Apache-2.0 |
| compatibility | Claude Code and compatible agent-skill hosts |
| homepage | https://github.com/aaron-he-zhu/seo-geo-claude-skills |
| when_to_use | Use when improving internal link structure, anchor text distribution, orphan pages, or site architecture. |
| argument-hint | <URL or sitemap> |
| metadata | {"author":"aaron-he-zhu","version":"9.9.12","geo-relevance":"low"} |
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 "${CLAUDE_PLUGIN_ROOT}/scripts/connectors/crawl.py" <url> | python3 "${CLAUDE_PLUGIN_ROOT}/scripts/connectors/linkgraph.py" - computes orphans, click-depth, and internal PageRank from a live crawl. See scripts/connectors/README.md.
Instructions
Label every metric Measured (tool/export), User-provided, or Estimated (model inference); never present an estimate as measured; if a required metric is unavailable, mark it N/A — do not invent it.
