Skip to content

Broken Internal Links Audit

Finds internal links that return 404 or 5xx errors and suggests fixes for them

Stars
74,632
Licence
MIT
Files
2 files

What it does

Once installed, the agent checks a website for internal links that lead to missing pages (404) or server errors (5xx), and recommends updating or removing those links. It is framed as an SEO checklist item, so it also explains why dead links waste search engine crawl budget. The description asks the agent to verify the rendered HTML and HTTP responses rather than relying only on source files. The skill is a short written guide; the detailed examples live in a reference file that was not included in this assessment's summary beyond its existence.

Great for

  • Developers or site owners who want a checklist-driven review of dead internal links after a site migration or content deletion
  • SEO specialists who want an agent to explain crawl budget and link health in plain language
  • Teams using the Front-End Checklist who want the agent to follow its SEO rule

Skip it if

  • Full site crawling at scale: the skill describes what to check but includes no crawler script, so results depend on what the agent can access in its environment
  • External or outbound link checking: the skill covers internal links only
  • Sites that cannot be reached from the agent's environment, such as private or staging sites behind login, where the audit cannot verify live responses

Try asking

  • “Audit my site for internal links that return 404 or 500 errors and list the source pages”
  • “After we moved our blog to a new URL structure, find any internal links that are now broken”
  • “Explain how broken internal links affect crawl budget and indexing on my site”
  • “Review our navigation templates for links pointing to pages that no longer exist”
Step-by-step guide: how to use Broken Internal Links AuditInstall, first run, examples, tips and FAQs

Install in 3 steps

  1. 1

    Download the skill

    The ZIP contains the 2 original files, the MIT licence and an attribution note.

    broken-links.zip
  2. 2

    Add it to your agent

    Claude Code (all projects)

    mkdir -p ~/.claude/skills && unzip broken-links.zip -d ~/.claude/skills/

    Claude Code / Agent SDK (this project only)

    mkdir -p .claude/skills && unzip broken-links.zip -d .claude/skills/

    Claude apps (web/desktop): Settings → Capabilities → Skills → Upload skill, and choose the ZIP.

  3. 3

    Ask for the task

    No special command needed — the agent reads the skill's description and loads it when your request matches. Try one of the prompts above.

Get better results

  • Give the agent the site's base URL and, if available, a sitemap so it can check the rendered pages and HTTP status codes directly.
  • Ask for a table of broken link, source page, and suggested fix so the results are easy to act on.
  • Check any suggested fixes yourself before editing content, especially where a redirect might be better than removing a link.

What's inside

  • references/rule.md
  • SKILL.md

Redistributed unmodified from thedaviddias/Front-End-Checklist under the MIT licence. The assessment was drafted with AI from the skill's files on 2026-10-29. Skills can instruct your agent to run code — read SKILL.md and any scripts before installing.