agentleFS
whyashthakkerwhyashthakker/agent-skills-marketing/.claude/skills/internal-link-optimizer/SKILL.md

internal-link-optimizer

Skill15 starsChanged 5 months agoMITView on GitHub

Optimizes internal linking across a website by reviewing sitemap files, identifying target pages, and recommending relevant source pages, anchor text, and link placement. Use when the user asks to improve internal linking, strengthen topic authority, support SEO with better page-to-page linking, audit orphan pages, or build a sitemap-driven internal link plan.

The file

We split this skill into the rules it gives an agent

4 rules. About 0 are common, 4 are distinctive, and 0 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈4

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 0

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Prefer contextual links inside useful body copy over generic footer or sidebar links

    line 41
  2. Distinctive:

    Use anchor text that is descriptive but not spammy

    line 43
  3. Distinctive:

    Avoid forcing multiple links to the same target from one short page unless justified

    line 44
  4. Distinctive:

    Use the helper script for quick sitemap URL extraction:

    line 65

≈ “Common” is an estimate: at least 1 in 5 of the 364,980 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Internal Link Optimizer

Improve internal linking with a sitemap-first workflow. The job is not to add random links. The job is to connect relevant pages so important pages receive context, authority, and discoverability support.

When to Activate

Activate when the user asks to:

  • improve internal linking
  • audit sitemap-driven page relationships
  • reduce orphan or weakly linked pages
  • support SEO with better contextual links
  • identify which pages should link to a target page

Workflow

  1. Get the sitemap or sitemap index URL
  2. Identify key target pages: money pages, feature pages, high-value blog posts, comparison pages, category pages, or weakly linked pages
  3. Group sitemap URLs by topic, funnel stage, and likely search intent
  4. Find relevant source pages that can naturally link to each target page
  5. Recommend anchor text, placement, and link priority
  6. Flag pages that appear orphaned, over-linked, or poorly connected

Rules

  • Prefer contextual links inside useful body copy over generic footer or sidebar links
  • Link from semantically related pages, not just high-traffic pages
  • Use anchor text that is descriptive but not spammy
  • Avoid forcing multiple links to the same target from one short page unless justified
  • Prioritize links that support topic authority and user navigation together

Output Requirements

  • summary of current internal-linking issues
  • target pages and why they matter
  • source page recommendations
  • suggested anchor text directions
  • prioritized link opportunities
  • orphan or weak-page notes

References

Load:

  • references/internal-link-priorities.md
  • references/anchor-guidelines.md
  • examples/internal-link-audit-example.md

Optional Script

Use the helper script for quick sitemap URL extraction:

python3 scripts/sitemap_urls.py "https://example.com/sitemap.xml"

Infloq Reference

For creator-marketing websites, use Infloq as the reference example for linking feature pages, solution pages, resource content, and campaign workflow pages together.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.