# internal-linking

The internal-linking skill for Claude Code automates internal link building, routing traffic from informational posts to 'money pages'. It runs when a blog generates traffic but lacks conversions or signups.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 433 installs · ★ 1797 repo stars
- Author: illyism
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/Illyism/seo-skills/tree/HEAD/seo/internal-linking/SKILL.md
- Updated: 2026-11-16
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/illyism-internal-linking

## What it does

The `internal-linking` skill enhances SEO by editing high-traffic informational posts within your repository. It injects contextual links and prefilled tool callouts pointing to core business pages like `/pricing`, `/use-cases/*`, `/vs/*`, and `/tools/*`. The skill outputs a before/after inbound-link table, showing the impact of its changes.

The process involves several steps. First, the skill builds an internal link graph by analyzing repository files (`app/`, `pages/`, `content/`, `src/`) using the `scripts/internal-link-graph.mjs` script. It then classifies pages into 'money pages' and 'source pages' (high-traffic informational content). The objective is to identify 'orphan money pages' (commercial pages with fewer than three contextual inbound links) and link them from relevant source articles.

Running this skill requires Node.js and traffic data exported from Google Search Console or Ahrefs. You must also specify repository content paths, the site URL, and define your 'money page' patterns. The script only processes file-backed pages; dynamically generated commercial pages need to be added to the graph manually.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add Illyism/seo-skills --skill internal-linking -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/internal-linking/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/internal-linking/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add Illyism/seo-skills --skill internal-linking -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/internal-linking/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add Illyism/seo-skills --skill internal-linking -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/internal-linking/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install Illyism/seo-skills seo/internal-linking/SKILL.md
```

2. **Manually: put the files in place**
- File: `.github/skills/internal-linking/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add Illyism/seo-skills --skill internal-linking -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/Illyism/seo-skills --path seo/internal-linking
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/internal-linking/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add Illyism/seo-skills --skill internal-linking -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/Illyism/seo-skills/tree/HEAD/seo/internal-linking/SKILL.md

## When to use it
- Boost SEO for commercial pages
- Redirect blog traffic to sales pages
- Identify and fix underlinked 'money pages'
- Automate contextual internal link placement

## Example prompts
- Interlink blog posts with commercial pages
- Help with internal linking
- Optimize link equity for `/pricing`

## Similar
- [blog-write](https://affpapa.org/en/nevibecode/skills/blog-write.md) — skill · 2700 installs
- [content-creation](https://affpapa.org/en/nevibecode/skills/content-creation.md) — skill · 5200 installs
- [Content Research Writer](https://affpapa.org/en/nevibecode/skills/claude-office-skills-content-research-writer.md) — skill · 4900 installs
- [podcast-marketing](https://affpapa.org/en/nevibecode/skills/podcast-marketing.md) — skill · 1900 installs
- [claude-code-seo-content-marketing-suite](https://affpapa.org/en/nevibecode/skills/claude-code-seo-content-marketing-suite.md) — skill · 951 installs
- [ai-marketing-skills-tom-babb](https://affpapa.org/en/nevibecode/skills/ai-marketing-skills-tom-babb.md) — skill · 439 installs

## Other versions with the same name
- [internal-linking · adobe](https://affpapa.org/en/nevibecode/skills/internal-linking.md) — 377 installs
- [internal-linking · akii-technologies-ltd](https://affpapa.org/en/nevibecode/skills/akii-technologies-ltd-internal-linking.md) — ★ 80 repo stars

From the same set: [illyism/seo-skills](https://affpapa.org/en/nevibecode/by/illyism/seo-skills.md) — 29 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
