///// Checks / Readability

Agent-friendly 404s

What an agent gets on a path that doesn't exist: a real 404 status, and whether the error body is readable Markdown.

Check id
agent-friendly-404
Pillar
Readability
Runs in
The free CLI
Scoring
Up to 2 points
Status
Pre-release, in calibration

Why it matters

A 200 that says 'not found' looks like content. A clear 404 with a short explanation tells the agent where to go next.

How to pass

Return 404 or 410 for missing pages and, for agents, a short Markdown body that links your docs or llms.txt.

Run it

Find agent-friendly-404 in the report. Add --md for a fix prompt you can paste into Claude Code, Codex or Cursor.

Free tools that include it

All checks→