Agent skill

Internal Linking Optimizer

by ViryaZheng in ViryaZheng/recomby-geo

A skill your agent uses when improving internal link structure, anchor text, orphan pages, crawl depth, site architecture, or link equity flow.

Apache-2.0Auto-check passedMarketing & SEO

Install Internal Linking Optimizer

skills CLI
$ npx skills add ViryaZheng/recomby-geo --skill internal-linking-optimizer -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install ViryaZheng/recomby-geo internal-linking-optimizer --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/ViryaZheng/recomby-geo.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/recomby-geo/skills/internal-linking-optimizer .claude/skills/internal-linking-optimizer && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
internal-linking-optimizer
GitHub stars
460
Token cost
~2k tokens
SKILL.md length
497 words
Files
4 (incl. references)
Skills in repo
4
Repo updated
First seen
Licence
Apache-2.0

At a glance

A skill your agent uses when improving internal link structure, anchor text, orphan pages, crawl depth, site architecture, or link equity flow.

  • Works in 7 steps: Analyze Current Structure -- Capture… → Identify Orphan Pages -- List pages with… → Analyze Anchor Text Distribution --… → …
  • Improving internal link structure
  • SKILL.md covers Quick Start, Skill Contract, Data Sources and Instructions, plus 4 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Internal Linking Optimizer is an agent skill from ViryaZheng/recomby-geo. Use when improving internal link structure, anchor text, orphan pages, crawl depth, site architecture, or link equity flow. 内链优化/站内架构

Its SKILL.md is about 2k tokens, which your agent loads only when the skill is triggered. The skill folder holds 4 other files, including reference files (for example `references/link-architecture-patterns.md`, `references/linking-example.md` and `references/linking-templates.md`). Compatibility notes: Claude Code, skills.sh, ClawHub, Vercel Labs, Cursor, Windsurf, Codex CLI, Amp, Gemini CLI, Kimi Code, Qwen Code, CodeBuddy

It sits in Marketing & SEO, covering On-page SEO, Link building and Web scraping. The repository describes itself as: GEO 领域 AI 员工开源方案 · Open-source GEO AI-employee solution (MIT). GEO Skills package + curated lists of agents and office CLIs that make up the AI-employee stack. The licence is Apache-2.0.

When your agent uses it

  • Improving internal link structure
  • Site architecture
  • Link equity flow

Example prompts

  • “/internal-linking-optimizer”

Requirements

  • Compatibility (from SKILL.md): Claude Code, skills.sh, ClawHub, Vercel Labs, Cursor, Windsurf, Codex CLI, Amp, Gemini CLI, Kimi Code, Qwen Code, CodeBuddy

Workflow steps

7 steps, taken from the first numbered list in SKILL.md.

  1. Analyze Current Structure -- Capture domain, pages analyzed, total internal links, average links/page, link distribution, top linked…
  2. Identify Orphan Pages -- List pages with no inbound internal links. Prioritize high-value orphans with traffic/rankings, medium-potential…
  3. Analyze Anchor Text Distribution -- Check current anchor patterns, distribution by page, over-optimization, generic anchors, and CORE-EEAT…
  4. Create Topic Cluster Link Strategy -- Map pillar/cluster links, recommend structure, and list specific links to add.
  5. Find Contextual Link Opportunities -- For each page, identify topic-relevant source/target/anchor opportunities and prioritize high-impact…
  6. Optimize Navigation and Footer Links -- Review main/footer/sidebar/breadcrumb navigation; recommend pages to add, demote, or remove.
  7. Generate Implementation Plan -- Include executive summary, current-state metrics, phased priority actions, implementation guide, and…

What it can do on your machine

Read from SKILL.md and the folder at commit 530d5e2. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • github.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

  • Compatibility

    Claude Code, skills.sh, ClawHub, Vercel Labs, Cursor, Windsurf, Codex CLI, Amp, Gemini CLI, Kimi Code, Qwen Code, CodeBuddy

    From compatibility in the SKILL.md frontmatter.

Context cost

Internal Linking Optimizer loads about 2k tokens when it runs, and up to ~4.7k if it reads all its reference files. Until then it costs about 40 tokens; SKILL.md has 497 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~40
When it runs · the whole SKILL.md, loaded when a task matches
~2k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~4.7k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from ViryaZheng/recomby-geo at commit 530d5e2, republished under its Apache-2.0 licence (© ViryaZheng). 497 words, ~2,026 tokens.

Download SKILL.mdSave it as .claude/skills/internal-linking-optimizer/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.
name
internal-linking-optimizer
description
Use when improving internal link structure, anchor text, orphan pages, crawl depth, site architecture, or link equity flow. 内链优化/站内架构
compatibility
Claude Code, skills.sh, ClawHub, Vercel Labs, Cursor, Windsurf, Codex CLI, Amp, Gemini CLI, Kimi Code, Qwen Code, CodeBuddy
version
9.9.5
license
Apache-2.0
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
metadata.version
9.9.5
metadata.geo-relevance
low
metadata.tags
seo, internal-linking, site-architecture, link-equity, orphan-pages, topical-authority, crawl-depth, 内链优化, 内部リンク, 내부링크, enlaces-internos
metadata.triggers
fix internal links, improve site architecture, internal linking strategy, link equity, orphan pages, site architecture is messy, pages have no links, how to…

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.

text
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.

Show full SKILL.md (145 more words)Show less

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

Next Best Skill

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

© ViryaZheng, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 3 other files (references) in plugins/recomby-geo/skills/internal-linking-optimizer of ViryaZheng/recomby-geo.

  • SKILL.md
  • references/link-architecture-patterns.md
  • references/linking-example.md
  • references/linking-templates.md

Open the folder on GitHubat commit 530d5e2

Compare with similar skills

Internal Linking Optimizer next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Internal Linking Optimizer compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Internal Linking Optimizer this skillViryaZheng/recomby-geo460—~2kAutomated safety check: PassApache-2.0
SEO DataforseoAgriciDaniel/codex-seo7912 repos~4.6kAutomated safety check: PassMIT
E2E SEO Assistantirinabuht12-oss/marketing-skills3.9k—~1.9kAutomated safety check: PassNone
Competitor Analysisaaron-he-zhu/aaron-marketing-skills2.9k1 repos~2kAutomated safety check: PassApache-2.0
Content Quality Auditoraaron-he-zhu/aaron-marketing-skills2.9k1 repos~2.8kAutomated safety check: PassApache-2.0
SEO Aeo Internal Linkinghenryalouf/ruflow156—~949Automated safety check: PassMIT

Similar skills

  • SEO Dataforseo

    AgriciDaniel/codex-seo

    Live SEO data via DataForSEO MCP server. An agent skill from AgriciDaniel/codex-seo.

    791 GitHub starsUsed in 2 repos~4.6k tokens
    Marketing & SEOAuto-check passed
  • E2E SEO Assistant

    irinabuht12-oss/marketing-skills

    Full SEO workflow covering technical audits, content gaps, backlink opportunities, on-page fixes, and content briefs.

    3.9k GitHub stars~1.9k tokensUpdated 14 days ago
    Marketing & SEOAuto-check passed
  • Competitor Analysis

    aaron-he-zhu/aaron-marketing-skills

    A skill your agent uses when the user asks to "analyze competitors" or "竞品分析"; benchmarks competitor keywords, content, backlinks, AI citations, and traffic share into strengths, weaknesses, and an…

    2.9k GitHub starsUsed in 1 repo~2k tokens
    Marketing & SEOAuto-check passed
  • Content Quality Auditor

    aaron-he-zhu/aaron-marketing-skills

    A skill your agent uses when auditing content quality, E-E-A-T, or publish readiness; runs a typed 80-item CORE-EEAT profile with evidence coverage, veto checks, and a fix plan.

    2.9k GitHub starsUsed in 1 repo~2.8k tokens
    Marketing & SEOAuto-check passed
  • SEO Aeo Internal Linking

    henryalouf/ruflow

    Maps internal link opportunities between pages with anchor text, placement instructions, orphan page detection, and cannibalization checks.

    156 GitHub stars~949 tokensUpdated 4 mo ago
    Marketing & SEOAuto-check passed
  • Competitor Profiling

    sickn33/agentic-awesome-skills

    When the user wants to research, profile, or analyze competitors from their URLs.

    47k GitHub starsUsed in 1 repo~3.6k tokens
    Marketing & SEOAuto-check passed

More from ViryaZheng/recomby-geo

  • Geo Review HTML

    ViryaZheng/recomby-geo

    Render an interactive, self-contained HTML companion for a GEO content brief (04-content-brief) or a publish-ready draft (05-production), so a NON-technical client reviewer (founder, organizer…

    460 GitHub stars~1.3k tokensUpdated 3 mo ago
    Auto-check passed
  • Content Writer

    ViryaZheng/recomby-geo

    Write SEO-optimized blog posts, landing pages, and long-form page copy following Google's E-E-A-T and Helpful Content guidelines.

    460 GitHub stars~2.4k tokensUpdated 3 mo ago
    Auto-check passed
  • Geo Pipeline

    ViryaZheng/recomby-geo

    Entry point + orchestrator for the recomby-geo GEO (Generative Engine Optimization) workflow on OpenAI Codex CLI.

    460 GitHub stars~1.1k tokensUpdated 3 mo ago
    Auto-check passed

Categories

Questions about Internal Linking Optimizer

What does Internal Linking Optimizer do?

A skill your agent uses when improving internal link structure, anchor text, orphan pages, crawl depth, site architecture, or link equity flow. Internal Linking Optimizer is an agent skill from ViryaZheng/recomby-geo. Use when improving internal link structure, anchor text, orphan pages, crawl depth, site architecture, or link equity flow.

When should I use Internal Linking Optimizer?

Internal Linking Optimizer fits situations like: improving internal link structure; site architecture; link equity flow.

How do I install Internal Linking Optimizer in Claude Code?

Run `npx skills add ViryaZheng/recomby-geo --skill internal-linking-optimizer -a claude-code`. Or copy the skill folder (plugins/recomby-geo/skills/internal-linking-optimizer in ViryaZheng/recomby-geo) into .claude/skills/internal-linking-optimizer in your project. Claude Code loads it when a task matches its description.

How do I install Internal Linking Optimizer in Codex?

Run `npx skills add ViryaZheng/recomby-geo --skill internal-linking-optimizer -a codex`. Or copy the skill folder (plugins/recomby-geo/skills/internal-linking-optimizer in ViryaZheng/recomby-geo) into .agents/skills/internal-linking-optimizer in your project. Codex loads it when a task matches its description.

Can I use Internal Linking Optimizer in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add ViryaZheng/recomby-geo --skill internal-linking-optimizer -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/internal-linking-optimizer, .gemini/skills/internal-linking-optimizer, .github/skills/internal-linking-optimizer and .opencode/skills/internal-linking-optimizer in your project.

What does Internal Linking Optimizer need to run?

SKILL.md names no scripts, command-line tools or credentials: Internal Linking Optimizer is instructions for the agent only. Compatibility (from SKILL.md): Claude Code, skills.sh, ClawHub, Vercel Labs, Cursor, Windsurf, Codex CLI, Amp, Gemini CLI, Kimi Code, Qwen Code, CodeBuddy.

Does Internal Linking Optimizer access the network?

SKILL.md names 1 domain. As links in the text: github.com. This is read from the text; nothing was executed.

Is Internal Linking Optimizer safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Internal Linking Optimizer use?

Internal Linking Optimizer is published under the Apache-2.0 licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Internal Linking Optimizer use?

About 2k tokens (SKILL.md is roughly 8.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 2.7k tokens, read only when the agent opens those files.

What are the alternatives to Internal Linking Optimizer?

Skills that share tags, products or a category with Internal Linking Optimizer: SEO Dataforseo (AgriciDaniel/codex-seo, 791 stars), E2E SEO Assistant (irinabuht12-oss/marketing-skills, 3.9k stars), Competitor Analysis (aaron-he-zhu/aaron-marketing-skills, 2.9k stars) and Content Quality Auditor (aaron-he-zhu/aaron-marketing-skills, 2.9k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Internal Linking Optimizer?

ViryaZheng (a GitHub user) maintains it in ViryaZheng/recomby-geo, which has 460 GitHub stars. The repository holds 4 skills in this directory. The repository was last updated on July 4, 2026.

Source: ViryaZheng/recomby-geo on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.