Internal Linking Skill

Description

Activate this skill when the user wants to build, audit, or optimise the internal link structure across a set of pages or a full site. Trigger phrases include: "internal linking strategy", "find internal link opportunities", "link these pages together", "internal link map", "suggest anchor text", "fix orphan pages", "internal links for [page or topic]", "link equity distribution".

Input Format

{
  "pages": [
    {
      "title": "string — page or post title",
      "url": "string — URL if published, leave blank if not yet live",
      "primary_keyword": "string — the keyword this page targets",
      "page_type": "pillar | cluster-article | landing-page |
                    blog-post | product-page",
      "content_summary": "string — 1-2 sentences describing the page"
    }
  ],
  "focus_page": "string — title of the page you most want to
                  boost with incoming links",
  "cluster_context": "string — optional, paste content cluster
                       output to inform link map",
  "product_pages": ["string — product, signup, pricing, or demo pages that should receive relevant CTAs"],
  "audit_findings": "string — optional orphan, cannibalization, or priority findings"
}

For a foundational content system, ensure every article has a contextual path to a relevant product, signup, pricing, demo, or next-step page. Do not add the same CTA or exact-match anchor mechanically to every article; match the destination to the reader’s intent.

Link Type Definitions

This skill recognises four distinct link types. Every suggestion must be labelled with one:

Rule: Every cluster article must have at least one Cluster → Pillar link. No exceptions.

Anchor Text Rules

Anchor text is critical. Follow these rules on every suggestion:

If the skill detects the same exact-match anchor being used more than once for the same target page, flag it as a Cannibalization Risk in the output.

Output Structure

The skill must always produce output in this exact format:

# Internal Linking Report

## Summary

| Metric                          | Value      |
|---------------------------------|------------|
| Total Pages Analysed            | [n]        |
| Total Link Opportunities Found  | [n]        |
| Orphan Pages Detected           | [n]        |
| Cannibalization Risks           | [n]        |
| Focus Page Incoming Links       | [n]        |
| Pages Exceeding Link Limit      | [n]        |

---

## Orphan Page Alert

Pages with no incoming internal links — these are invisible
to search engines and must be linked immediately:

| Page Title                  | URL                  | Fix                              |
|-----------------------------|----------------------|----------------------------------|
| [title]                     | [url or "unpublished"]| Link from [suggested source page]|

---

## Link Opportunities

Listed in priority order — highest impact first.

---

### 🔴 High Priority — Do These First

**Link [n]**
| Field              | Value                                             |
|--------------------|---------------------------------------------------|

…