How to use the Internal Links Audit agent skill

What the internal-links skill makes the agent do

Once installed, the agent reviews how pages on a website link to each other. It can work from a site crawl to count how many internal links point to important pages, flag orphan or under-linked pages, and check whether anchor text is descriptive.

It can also propose contextual links, related-article sections, or navigation changes to strengthen key pages. It follows an SEO checklist approach and explains its reasoning in plain terms.

• Count unique internal pages linking to each important page
• Check whether anchor text includes keywords relevant to the target page
• Flag pages with 0 to 2 incoming internal links as likely orphans or under-linked
• Verify links sit in body content, not only in global navigation or footer
• Suggest a 'Related articles' or 'See also' section and pillar-to-cluster links

Install the internal-links skill

The skill is distributed as a ZIP file from the skill's page on this directory. Download the ZIP and unzip it into one of these locations, depending on how you want to use it.

For personal use across projects, unzip it into ~/.claude/skills/. For a single project, unzip it into that project's .claude/skills/ folder.

If you use the Claude apps instead, open Settings, go to Capabilities, and upload the skill under Skills.

• Personal: ~/.claude/skills/
• Project only: .claude/skills/ inside your project folder
• Claude apps: Settings → Capabilities → Skills, then upload

Trigger the skill with natural requests

You do not need a special command. Describe what you want in plain language and the agent should match the request to the skill's description. The skill is meant for auditing link structure, finding pages that need more incoming links, generating contextual linking ideas between related content, and reviewing a CMS template's linking patterns.

Giving the agent a site crawl or a list of key pages makes the audit far more useful than asking in the abstract.

• 'Audit the internal links on our site using this crawl export and tell me which key pages are under-linked.'
• 'Find orphan pages in this sitemap and suggest where contextual links could go.'
• 'Review our blog article template for internal linking patterns.'
• 'Plan links between our pillar page on CSS Grid and its supporting articles.'

Example workflow for a content cluster

Start by listing your top 10 to 20 most important pages by business value. Then ask the agent to find topically related pages that could link to them with descriptive anchor text.

The skill's own example replaces generic text such as 'click here' with descriptive wording such as 'our guide to CSS Grid'. Review each suggested link in context before you publish it, since the agent proposes changes rather than knowing your editorial goals.

• Step 1: give the list of key pages
• Step 2: ask for related content that could link to each one
• Step 3: check that anchor text reads naturally
• Step 4: confirm pillar and cluster pages link both ways

What the skill needs and safety notes

The skill lists no required tools or packages. It does not run scripts and does not use the network, so it works from the files and data you provide, such as a crawl export.

The guidance assumes public, indexed pages. It is not suited to internal tools or apps behind logins. The skill's reference notes describe PageRank reasoning as a general principle, and results depend on many other factors, so do not expect guaranteed ranking gains.

• Requires: nothing listed
• Runs scripts: no
• Uses network: no
• Licence: MIT
• Included files: SKILL.md and references/rule.md

Tips for better results

Give the agent real data. A crawl showing which pages link to which is the input the skill is built around. Without it, the agent can only offer general advice.

Prioritise pages with the fewest incoming links first, and be cautious about pages that should stay out of search. The skill's check flags pages that are in the sitemap and not excluded by robots or noindex, so mention those settings if you know them.

• Provide a crawl or link list, not just a URL
• Start with your most valuable pages
• Keep anchor text natural rather than stuffing keywords