Redirect Audit Claude Skill
This skill audits a website's redirects and produces an actionable report. It resolves the full redirect chain for every URL to find redirect chains and loops, redirects that end in 404s or errors, temporary 302 redirects used for permanent moves, HTTPS-to-HTTP downgrades, client-side meta-refresh and JavaScript redirects, dropped query strings, and canonicals that point at redirecting URLs.
Quick Take
Point the skill at a site root, sitemap, or URL list. It traces every redirect hop, runs ten severity-ranked checks, and returns a prioritized report with exact rewrite rules to collapse chains to a single 301.
What The Skill Checks
- Chain integrity: multi-hop redirect chains, redirect loops, chains that exceed the hop limit, and redirects that end in a 4xx, 5xx, or error instead of a live page.
- Protocol and status problems: HTTPS-to-HTTP downgrades and temporary 302 redirects used where a permanent 301 belongs, plus client-side meta-refresh and JavaScript redirects that search engines treat differently from server redirects.
- Equity and consistency signals: redirects that silently drop the query string and canonical tags that point at a redirecting URL instead of the final destination.
How The Skill Is Packaged
The skill follows the standard Claude Agent Skill structure: a SKILL.md file with YAML frontmatter and workflow instructions, a references/ folder with the full audit check definitions and report template, and a scripts/ folder with Python scripts that resolve redirect chains and audit them. Copy the skill folder into your Claude skills directory and Claude invokes it automatically when a request matches its description.
Skill Files
Every file in the skill is embedded below directly from the Claude-SEO-Skills repository, so you can review exactly what the skill instructs Claude to do before installing it.
SKILL.md
The skill definition: frontmatter, inputs to collect (including hop limits), the four-step workflow, and the resources the skill relies on.
Audit Checks Reference (references/audit-checks.md)
Full definitions, severities, and rationale for all ten checks, from a chain ending in a 4xx/5xx to a silently dropped query string.
Report Template (references/report-template.md)
The output structure the skill follows, including the summary, hop distribution, issues grouped by severity, and prioritized fixes with exact rewrite rules.
Redirect Collector Script (scripts/collect_redirects.py)
Resolves the full redirect chain for a site root, sitemap, or URL list, recording each hop's status code, target, and final destination details into a JSON inventory.
Redirect Auditor Script (scripts/audit_redirects.py)
Runs the audit checks against the redirect inventory and outputs the structured report data, including chain length distributions and flagged issues.