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:
- Which important pages are difficult or impossible to reach through internal links?
- Which internal links are broken, redirected, non-descriptive, or otherwise inefficient?
- 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.