internal-linking · illyism — Claude Code skill: what it does, how to install
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.
no license 433 installs ★ 1,797 updated 2026-11-16
npx skills add Illyism/seo-skills --skill internal-linking -a claude-codeWhat internal-linking 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.
What it helps with
- Boost SEO for commercial pages
- Redirect blog traffic to sales pages
- Identify and fix underlinked 'money pages'
- Automate contextual internal link placement
Example prompts for the agent
- Interlink blog posts with commercial pages
- Help with internal linking
- Optimize link equity for
/pricing
How to install internal-linking
1Skills CLI (Vercel)
npx skills add Illyism/seo-skills --skill internal-linking -a claude-code2Manually: put the files in place
~/.claude/skills/internal-linking/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/internal-linking/
1Skills CLI (Vercel)
npx skills add Illyism/seo-skills --skill internal-linking -a codex2Manually: put the files in place
.agents/skills/internal-linking/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add Illyism/seo-skills --skill internal-linking -a cursor2Manually: put the files in place
.cursor/skills/internal-linking/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install Illyism/seo-skills seo/internal-linking/SKILL.md2Manually: put the files in place
.github/skills/internal-linking/SKILL.md1Skills CLI (Vercel)
npx skills add Illyism/seo-skills --skill internal-linking -a gemini-cli2Platform CLI
gemini skills install https://github.com/Illyism/seo-skills --path seo/internal-linkingManually: put the files in place
.devin/skills/internal-linking/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add Illyism/seo-skills --skill internal-linking -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about internal-linking
How to install internal-linking in Claude Code?
Install the skill using the command npx skills add Illyism/seo-skills --skill internal-linking -a claude-code. The skill file will be available at ~/.claude/skills/internal-linking/SKILL.md.
What does the internal-linking skill do?
The internal-linking skill analyzes your repository, identifies high-traffic informational articles and commercial pages, then adds contextual links from the former to the latter. This helps redirect link equity and traffic.
What is required for internal-linking to work?
The skill requires Node.js, traffic data exported from Google Search Console or Ahrefs, your site URL, and repository content paths. Dynamically generated commercial pages need manual addition to the graph.
Similar skills
All skills for SEO and GEO →internal-linking by other authors comes first.