internal-link-audit

Installation
SKILL.md

Internal link audit

Audit a site's internal linking and produce an evidence-labeled remediation plan. Answer three questions:

  1. Which important pages are difficult or impossible to reach through internal links?
  2. Which internal links are broken, redirected, non-descriptive, or otherwise inefficient?
  3. Which contextual links and hub relationships would make the architecture clearer?

Do not treat internal linking as a quota exercise. Recommend links only when the source, destination, and user journey are contextually related.

Rule provenance

Keep these evidence classes distinct in the analysis and final output.

  • Semrush-supported guidance: internal links help search engines discover pages, communicate hierarchy and context, and distribute authority. Semrush recommends descriptive anchors, relevant hub-and-spoke relationships, and supporting new content with contextual incoming links.
  • MCP contract requirement: project-backed findings come only from reports and fields returned by the official Semrush MCP. A product-UI feature name is not an MCP report name.
  • Industry heuristic: prioritization based on business importance, likely user impact, or remediation effort is analyst judgment unless backed by supplied first-party data.
  • User-configurable default: limits, samples, and priority weights must adapt to the site's size, goals, and available data. Never turn them into universal SEO rules.
Installs
65
Repository
semrush/skills
GitHub Stars
11
First Seen
Sep 18, 2026