Broken Link Checker Agent Skill

> Scans a website to find broken links (404s, 500s). Crawls internal pages, identifies broken outbound links, and reports source pages for easy fixing. Use this when the user asks to "check for broken links", "find 404s", "audit my links", or "is my site healthy".

2k tokens

context cost

the whole folder, loaded on every use

files

ships runnable scripts

copies elsewhere

how many repositories repackaged it

3345

stars on the repo

on the repository, not the skill itself

Install

one command, takes just this skill from the repository

npx skills add https://github.com/nowork-studio/NotFair --skill broken-link-checker

What comes with it

6 981 bytes besides the instruction

evals/evals.json

scripts/checker.py

The instruction itself

5 sections, as written by the author

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!

Other skills for the same job

different authors, same section of the catalogue

Apify Automation

by christophacham

×2

Automate web scraping and data extraction with Apify -- run Actors, manage datasets, create reusable tasks, and retrieve crawl results through the Composio Apify integration.

Scrapes content based on a preset URL list, filters high-quality technical information, and generates daily Markdown reports.

Web search, content extraction, crawling, and research capabilities using Tavily API

| Bulk extract content from an entire website or site section. Use this skill when the user wants to crawl a site, extract all pages from a docs section, bulk-scrape multiple pages following links, or says "crawl", "get all the pages", "extract everything under /docs", "bulk extract", or needs content from many pages on the same site. Handles depth limits, path filtering, and concurrent extraction.

Deep web scraping, screenshots, PDF parsing, and website crawling using Firecrawl API. Use when you need deep content extraction from web pages, page interaction is required (clicking, scrolling, etc.), or you want screenshots or PDF parsing.

Build a fully automated AI-powered data collection agent for any public source — job boards, prices, news, GitHub, sports, anything. Scrapes on a schedule, enriches data with a free LLM (Gemini Flash), stores results in Notion/Sheets/Supabase, and learns from user feedback. Runs 100% free on GitHub Actions. Use when the user wants to monitor, collect, or track any public data automatically.

Scrapes content based on a preset URL list, filters high-quality technical information, and generates daily Markdown reports.

Scrape, crawl, search, and extract structured data from websites using Firecrawl API - converts web pages to LLM-ready markdown

6k tokens scripts

How to use it

Copy the folder

Take nowork-studio/broken-link-checker from the repository into ~/.claude/skills for personal use, or into .claude/skills inside a project.

Check the name does not clash

The agent identifies a skill by the name field in its header. Two skills with the same name cannot sit side by side — one of them will be ignored.