Agent skill

Internal Links

by kostja94 in kostja94/marketing-skills

When the user wants to optimize internal linking, fix orphan pages, or improve link structure.

MITAuto-check passedMarketing & SEO

Install Internal Links

skills CLI
$ npx skills add kostja94/marketing-skills --skill internal-links -a claude-code

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

GitHub CLI
$ gh skill install kostja94/marketing-skills internal-links --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/kostja94/marketing-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/seo/on-page/internal-links .claude/skills/internal-links && 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-links
GitHub stars
1k
Token cost
~854 tokens
SKILL.md length
364 words
Files
1
Skills in repo
102
Repo updated
First seen
Licence
MIT

At a glance

When the user wants to optimize internal linking, fix orphan pages, or improve link structure.

  • Works in 3 steps: Site structure: Hub pages, pillar… → Orphan pages: Pages with no or few… → Priority pages: Pages that need more…
  • Wants to optimize internal linking
  • SKILL.md covers Scope (On-Page SEO), Initial Assessment, Best Practices and Common Issues, plus 2 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Internal Links is an agent skill from kostja94/marketing-skills. When the user wants to optimize internal linking, fix orphan pages, or improve link structure. Also use when the user mentions "internal links," "internal linking," "anchor text," "link equity," "internal linking strategy," or "orphan pages." For IA, use website-structure.

Its SKILL.md is about 850 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Marketing & SEO, covering On-page SEO and Link building. The repository describes itself as: Agent Skills for Marketing — SEO, Social, Influencer & More. 160+ open-source skills for SEO, content, 40+ page types, paid ads, channels, and strategies. Add project context… The licence is MIT.

When your agent uses it

  • Wants to optimize internal linking
  • Fix orphan pages
  • Improve link structure
  • The user mentions internal links

Example prompts

  • “internal links,”
  • “internal linking,”
  • “anchor text,”
  • “/internal-links”

Workflow steps

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

  1. Site structure: Hub pages, pillar content, supporting pages
  2. Orphan pages: Pages with no or few internal links
  3. Priority pages: Pages that need more link equity

What it can do on your machine

Read from SKILL.md and the folder at commit 8dd89c5. 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

    No URLs in SKILL.md.

    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.

Context cost

Internal Links loads about 854 tokens when it runs. Until then it costs about 72 tokens; SKILL.md has 364 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~72
When it runs · the whole SKILL.md, loaded when a task matches
~854

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 kostja94/marketing-skills at commit 8dd89c5, republished under its MIT licence (© kostja94). 364 words, ~854 tokens.

Download SKILL.mdSave it as .claude/skills/internal-links/SKILL.md (or your agent's skills folder).
name
internal-links
description
When the user wants to optimize internal linking, fix orphan pages, or improve link structure. Also use when the user mentions "internal links," "internal linking," "anchor text," "link equity," "internal linking strategy," or "orphan pages." For IA, use website-structure.
metadata.version
1.0.1

Guides internal linking strategy for SEO: crawlability, link equity distribution, and user navigation.

When invoking: On first use, if helpful, open with 1–2 sentences on what this skill covers and why it matters, then provide the main output. On subsequent use or when the user asks to skip, go directly to the main output.

Scope (On-Page SEO)

  • Internal links: Contextual links; descriptive anchor text; related posts; hub pages
  • Breadcrumbs: Implement for large sites (e.g. ecommerce); see breadcrumb-generator

Initial Assessment

Project context: Read root contextus.md when present and load only the modules relevant to this task. Without Contextus, use available project material or user-provided facts and ask for missing information; do not create a parallel context system.

Identify:

  1. Site structure: Hub pages, pillar content, supporting pages
  2. Orphan pages: Pages with no or few internal links
  3. Priority pages: Pages that need more link equity

Best Practices

PrincipleGuideline
DepthImportant pages within 3 clicks from homepage
Orphan pagesAvoid; ensure every page has at least one internal link; see site-crawlability for technical detection and crawl issues
Hub-to-spokeLink from hub/pillar pages to cluster articles; topic cluster structure
ContextualPlace links in relevant body content, not just footers
Anchor Text
PrincipleGuideline
DescriptiveUse anchor text that describes the target page
VariationAvoid over-optimization; use natural variation
KeywordInclude target keyword when natural
Show full SKILL.md (135 more words)Show less
Placement
LocationUse
First paragraphPrimary link to related content
BodyContextual links throughout
Related/RecommendedEnd-of-article links
NavigationKey site sections

Common Issues

IssueFix
Orphan pagesAdd internal links from hub pages or navigation; site-crawlability for technical audit
Too many linksFocus on most important; avoid link stuffing
Generic anchorsUse descriptive "learn more about X" instead of "click here"
Broken linksAudit and fix 404s; see site-crawlability for technical audit

Output Format

  • Internal link audit (if auditing)
  • Link opportunities for key pages
  • Anchor text recommendations
  • Structure improvements
  • article-page-generator: Related posts, contextual links, end-of-article recommendations
  • website-structure: Plan page structure and hierarchy; informs internal linking
  • site-crawlability: Internal links enable crawling
  • url-structure: URL structure affects link patterns
  • content-strategy: Topic clusters inform link structure; pillar <-> cluster; cluster <-> cluster
  • breadcrumb-generator: Breadcrumbs are internal links; category hierarchy

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

Files

Just SKILL.md in skills/seo/on-page/internal-links of kostja94/marketing-skills.

Open the folder on GitHubat commit 8dd89c5

Compare with similar skills

Internal Links 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 Links compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Internal Links this skillkostja94/marketing-skills1k—~854Automated safety check: PassMIT
E2E SEO Assistantirinabuht12-oss/marketing-skills4k—~1.9kAutomated safety check: PassNone
Internal Linking OptimizerViryaZheng/recomby-geo459—~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 Linkingsickn33/agentic-awesome-skills47k1 repos~2.3kAutomated safety check: PassMIT
SEO Aeo Internal Linkinghenryalouf/ruflow157—~949Automated safety check: PassMIT

Similar skills

  • E2E SEO Assistant

    irinabuht12-oss/marketing-skills

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

    4k GitHub stars~1.9k tokensUpdated 15 days ago
    Marketing & SEOAuto-check passed
  • Internal Linking Optimizer

    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.

    459 GitHub stars~2k tokensUpdated 3 mo ago
    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

    sickn33/agentic-awesome-skills

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

    47k GitHub starsUsed in 1 repo~2.3k 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.

    157 GitHub stars~949 tokensUpdated 4 mo ago
    Marketing & SEOAuto-check passed
  • Internal Linking

    adobe/skills

    Analyze and improve the internal link structure of an AEM Edge Delivery Services site.

    197 GitHub stars~1.8k tokensUpdated today
    Marketing & SEOAuto-check passed

More from kostja94/marketing-skills

All 102 skills in this repo
  • Grokipedia Recommendations

    kostja94/marketing-skills

    When the user wants to add recommendations, links, or content to Grokipedia.

    1k GitHub starsUsed in 1 repo~4.2k tokens
    Auto-check passed
  • AI Traffic Tracking

    kostja94/marketing-skills

    When the user wants to track AI search traffic in GA4 or GSC.

    1k GitHub stars~959 tokensUpdated 3 days ago
    Auto-check passed
  • Analytics Tracking

    kostja94/marketing-skills

    When the user wants to set up, audit, or optimize analytics tracking (GA4, events, conversions).

    1k GitHub stars~1.5k tokensUpdated 3 days ago
    Auto-check passed
  • Brand Visual Generator

    kostja94/marketing-skills

    When the user wants to define, audit, or apply visual identity (typography, colors, spacing, design tokens, frontend aesthetics).

    1k GitHub stars~3k tokensUpdated 3 days ago
    Auto-check passed
  • Canonical Tag

    kostja94/marketing-skills

    When the user wants to configure canonical URLs, fix duplicate content, or consolidate URL signals.

    1k GitHub stars~1.2k tokensUpdated 3 days ago
    Auto-check passed
  • Content Strategy

    kostja94/marketing-skills

    When the user wants to plan content for SEO, create content calendar, or build topic clusters.

    1k GitHub stars~1.8k tokensUpdated 3 days ago
    Auto-check passed

Categories

Questions about Internal Links

What does Internal Links do?

When the user wants to optimize internal linking, fix orphan pages, or improve link structure. Internal Links is an agent skill from kostja94/marketing-skills. When the user wants to optimize internal linking, fix orphan pages, or improve link structure.

When should I use Internal Links?

Internal Links fits situations like: wants to optimize internal linking; fix orphan pages; improve link structure; the user mentions internal links.

How do I install Internal Links in Claude Code?

Run `npx skills add kostja94/marketing-skills --skill internal-links -a claude-code`. Or copy the skill folder (skills/seo/on-page/internal-links in kostja94/marketing-skills) into .claude/skills/internal-links in your project. Claude Code loads it when a task matches its description.

How do I install Internal Links in Codex?

Run `npx skills add kostja94/marketing-skills --skill internal-links -a codex`. Or copy the skill folder (skills/seo/on-page/internal-links in kostja94/marketing-skills) into .agents/skills/internal-links in your project. Codex loads it when a task matches its description.

Can I use Internal Links 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 kostja94/marketing-skills --skill internal-links -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-links, .gemini/skills/internal-links, .github/skills/internal-links and .opencode/skills/internal-links in your project.

What does Internal Links need to run?

SKILL.md names no scripts, command-line tools or credentials: Internal Links is instructions for the agent only.

Does Internal Links access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Internal Links 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 Links use?

Internal Links is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Internal Links use?

About 854 tokens (SKILL.md is roughly 3.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Internal Links?

Skills that share tags, products or a category with Internal Links: E2E SEO Assistant (irinabuht12-oss/marketing-skills, 4k stars), Internal Linking Optimizer (ViryaZheng/recomby-geo, 459 stars), Content Quality Auditor (aaron-he-zhu/aaron-marketing-skills, 2.9k stars) and SEO Aeo Internal Linking (sickn33/agentic-awesome-skills, 47k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Internal Links?

kostja94 (a GitHub user) maintains it in kostja94/marketing-skills, which has 1,025 GitHub stars. The repository holds 102 skills in this directory. The repository was last updated on October 6, 2026.

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