Complete AI Training
Sign inGet my AI kit

Your job's AI kit

Get your AI kit

Tell us who you are and what you do. We show you your kit right away and email you the link: skills, prompts, AI agents, MCP servers and courses for your job.

500+ jobs ready, and we make a kit for any other job. No payment needed to look.

Share

AI agent for technical writers

Broken Link and Redirect Audit Agent

A docs site where every link resolves to the right current page

Quality controlIT and developmentWriters
See how it worksGet access
Broken Link and Redirect Audit Agent: what goes in, what the agent does and what you get

What it does

After a docs move or a product rename, links break quietly, and readers land on error pages. This agent crawls the docs site and lists broken links, redirect chains and links that point to old versions. For each one it searches the current site for the page that now holds the content and checks that the new target covers the same topic. It drafts edits to the source files and, where many pages share a moved URL, a redirect rule instead. After the writer approves, it applies the changes to a draft build, recrawls the site and checks that every link now resolves in one step. If some still fail, it repeats the search and fix. Edge case: two old pages merged into one, so the agent picks the section anchor.

How it works

Follow the arrows from top to bottom. The orange dashed arrow is the loop: when a check fails, the agent goes back and tries again.

Start and resultWhat it doesA check on its own workWaits for your OKGoes back and retries
Yes, continueApprovedYes, continueApprovedNoNo 1 STARTS WHEN Monthly crawl runs or a content move is announced 2 USES A TOOL Crawl the docs site and list broken, redirected andold-version links 3 USES A TOOL Search the current site for each content replacement 4 CHECKS THE RESULT Does a replacement page cover the same topic? If not: mark the link for the writer and list candidatepages. Back to step 3. 5 DOES Draft source edits and redirect rules 6 YOU APPROVE Writer approves the edits and the redirect list 7 USES A TOOL Apply the changes to a draft build and recrawl 8 CHECKS THE RESULT Does every link now resolve in one step? If not: repeat the search and fix for the remaininglinks. Back to step 3. 9 DOES Write the change summary 10 YOU APPROVE Writer approves publishing 11 RESULT Link audit report and updated site
Read the steps as a list
  1. Monthly crawl runs or a content move is announced
  2. Crawl the docs site and list broken, redirected and old-version links
  3. Search the current site for each content replacement
  4. Does a replacement page cover the same topic?If not: mark the link for the writer and list candidate pages. Back to step 3.
  5. Draft source edits and redirect rules
  6. Writer approves the edits and the redirect listThe agent waits here for your OK.
  7. Apply the changes to a draft build and recrawl
  8. Does every link now resolve in one step?If not: repeat the search and fix for the remaining links. Back to step 3.
  9. Write the change summary
  10. Writer approves publishingThe agent waits here for your OK.
  11. Link audit report and updated site

How it decides

A replacement is accepted only if the new page covers the same topic and the link resolves directly. Many broken links to one URL get a redirect, a single page gets an edit.

  • Use a redirect rule when more than 5 pages link to the same dead URL
  • Use an edit for a single page link
  • Collapse redirect chains to a single hop
  • Point to a section anchor when pages merged

Make it yours

Every agent is a starting point. You choose these settings for your own situation.

  • Crawl schedule (default monthly)
  • Link types to check
  • Redirect threshold (default 5 pages)
  • Sites it crawls

What keeps you in control

It always asks you first

  • Source edits
  • Redirect rules
  • Publishing

Hard limits

  • Never publishes without approval
  • Never deletes pages

It stops when

  • Done: recrawl shows zero broken links and no chains
  • Stop: the crawler cannot reach the site

Set it up

We guide you through the set-up, step by step

Members get the full set-up guide for this agent. No technical skills needed: you copy, paste and upload.

10 minto set it up in your AI
5 AIsChatGPT, Claude, Copilot, Gemini, Grok
  • One set of instructions to paste into your AI, with the clicks for ChatGPT, Claude, Microsoft 365 Copilot, Gemini and Grok
  • The agent then walks you through connecting your own data, one source at a time
  • A downloadable copy with the flow chart, the rules and the full guide
Get access to this agent

An example run

What happensAfter a rename, the crawl found 87 broken links and 22 redirect chains. The agent matched 79 to new pages, and 8 had no clear match. It drafted 31 edits and 6 redirect rules. After approval and a draft recrawl, 4 links still failed because a section anchor had changed. The agent fixed them and the writer approved publishing 83 changes, leaving 4 for review.

More agents for technical writers

Compliance · Quality control

Editorial Revision Compliance Agent

A revision compliance map and response for the editor.

7 steps1 check7 jobs
Quality control · Writers

Article Structure Revision Agent

A tracked structural revision that keeps the argument fully supported.

7 steps1 check6 jobs
Compliance · Creatives

Copy Approval Chain Tracker Agent

One locked copy version with a complete record of who approved it

9 steps2 checks7 jobs
Quality control · Automation

Web Content Translation Sync Agent

Keep every translated page in sync with its source, with verified text and rendering.

10 steps2 checks7 jobs