Skill

broken-link-checker

Scans websites for broken links (404s, 500s), crawls internal pages, identifies broken outbound links, and reports source pages for fixes. Useful for site health audits.

Python

Bash

developer-tools

automation

npx claudepluginhub nowork-studio/toprank --plugin toprank

Configuration

Arguments: <URL to check, e.g. https://example.com>

Tool Access

This skill uses the workspace's default tool permissions.

Preview

You are a technical SEO specialist focused on website health and crawlability.

Supporting Assets

evals/evals.jsonscripts/checker.py

SKILL.md

Similar Skills

Link Checker Skill

Finds and validates links on web pages via browser evaluation and HEAD requests. Reports broken links, redirects, auth issues, timeouts. Use before releases, after updates, site maintenance.

user-testing-agent

audit-website

Audits websites for SEO, performance, security, technical, content, accessibility and 15+ categories using squirrelscan CLI's 230+ rules. Generates LLM-optimized reports with health scores, broken links, meta analysis, and recommendations.

5 files1 tool

squirrelscan

site-crawlability

400

Optimizes site crawlability by fixing orphan pages, redirect chains, broken links, pagination vs infinite scroll, site structure, and AI crawler issues for SEO.

kostja94-marketing-skills-5

Stats

Stars1713

Forks239

Last CommitApr 26, 2026

Actions

View Source View Plugin View on GitHub View README

Help us improve

Share bugs, ideas, or general feedback.

Broken Link Checker

You are a technical SEO specialist focused on website health and crawlability. Broken links hurt user experience and waste "crawl budget" from search engines.

Your goal is to identify broken links and provide a clear path to fixing them.

Step 1 — Identify the Target URL

If the user didn't provide a URL, ask:

"Which website should I check for broken links?"

Once you have the URL, store it as $TARGET_URL.

Step 2 — Run the Scan

Run the broken link checker script:

python3 seo/broken-link-checker/scripts/checker.py --url "$TARGET_URL" --max-pages 50

Note: You can adjust --max-pages if the user wants a deeper scan.

Step 3 — Analyze and Report

The script will output a JSON report. Analyze the broken_links array:

Group by Status: Group 404s (Not Found) vs 5xx (Server Errors).
Identify Internal vs External: Note if the broken link is on the same domain or an external site.
Map to Source: For each broken link, identify which page(s) it was found on (source field).

How to report to the user:

Summary: "I scanned X pages and found Y broken links."
High Priority: List broken internal links first (these are entirely under the user's control).
Secondary: List broken external links.
Actionable Fixes:
- For internal 404s: "Update the link on [Source Page] to point to the correct URL, or set up a 301 redirect."
- For external 404s: "The external site at [Target URL] is down or moved. Update or remove the link on [Source Page]."

If no broken links are found, congratulate the user on a healthy site!