Internal Linking Optimizer

Use when improving internal link structure, anchor text, orphan pages, crawl depth, site architecture, or link equity flow. 内链优化/站内架构

Security Scan

Instruction-only SEO skill that is coherent with its stated purpose: it analyzes internal linking and emits a prioritized implementation plan, and it does not request credentials or install code.

Purpose & Capability

The name/description (internal linking optimization) matches the SKILL.md instructions and the included templates. It asks for sitemaps, key URLs, or analytics when available — all relevant to the task. Nothing requested (no env vars, no binaries, no config paths) is unrelated to SEO/link analysis.

Instruction Scope

Instructions are narrowly scoped to analyzing internal links, identifying orphans, anchor-text distribution, navigation/footer recommendations, and producing an implementation plan. The skill may read available state documents (CLAUDE.md, State Model) and writes audit summaries to memory/audits and related memory files — behaviour consistent with an audit/assistant skill. It does not instruct broad system file reads, credential harvesting, or exfiltration to third-party endpoints.

Install Mechanism

No install spec and no code files to run; the skill is instruction-only, which minimizes disk/write risk. There is no download or extract step.

Credentials

The skill declares no required environment variables or credentials. It states it will use web crawling and analytics 'when connected' — connectors/credentials for analytics would be provided elsewhere by the agent or user, not by this skill. As shipped, it does not request unrelated secrets.

Persistence & Privilege

The skill will write produced audits and handoff summaries into agent memory paths (memory/audits/, memory/open-loops.md, memory/decisions.md). That is expected for an audit helper, but you should be aware it will create/modify those memory entries. always:false and no cross-skill config modification are observed.

Assessment

This is an instruction-only SEO assistant that appears to do what it says: analyze internal links and emit prioritised plans. It does not request credentials or install code, but it can use crawlers or analytics connectors if the agent/environment provides them — those connectors may require site access or analytics credentials you should review before granting. The skill will also write audit summaries into the agent's memory paths (memory/audits/, memory/open-loops.md). If you plan to let it access live site data or analytics, confirm (1) you trust the environment providing those connectors, (2) you consent to storing audit outputs in agent memory, and (3) you review the linked GitHub repo if you want more provenance about the author and templates.

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: the current page or site state, symptoms, prior audits, and current priorities from CLAUDE.md and the shared State Model 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.

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.

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 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 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 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 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 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 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-<topic>.md. Append veto-level issues to memory/hot-cache.md automatically.

Reference Materials

• Link Architecture Patterns -- Architecture models, selection thresholds, migration safeguards, and measurement targets
• Linking Templates -- Detailed output templates for steps 3-7
• Linking Example -- Full worked example for internal linking opportunities

Next Best Skill

Primary: on-page-seo-auditor -- verify that revised internal links support page-level goals.