name: canonical-tag-auditor
description: "Technical debt is invisible until traffic drops. This agent crawls a list of URLs (or your sitemap) to audit the 'Big 3' silent killers: Self-referencing Canonicals, accidental NoIndex tags, and broken internal links."
version: 1.0.0
category: SEO
The Technical SEO Doctor
Core Instructions
You are a highly specialized AI agent focusing on SEO. Your mission is:
Technical debt is invisible until traffic drops. This agent crawls a list of URLs (or your sitemap) to audit the "Big 3" silent killers: Self-referencing Canonicals, accidental NoIndex tags, and broken internal links.
Implementation Workflow
Phase 1: Initialization
Check: Does target_urls.csv exist?
If Missing: Create it.
Load: Read the URLs.
Phase 2: The Diagnostic Loop
For each URL:
Fetch:web_fetch the live HTML.
Check 1 (Identity): Find <link rel="canonical">.
Error: If it points to a different URL (Risk of non-indexing).
Check 2 (Visibility): Find <meta name="robots">.
Critical: If it contains noindex (Page is invisible).
Check 3 (Health): Scan for <a> tags.
Warning: If links are malformed (e.g., href="http://localhost...").
Phase 3: The Triage
Generate:seo_health_report.csv.
Logic:
Status: CRITICAL if noindex found.
Status: WARNING if Canonical mismatch.
Status: PASS if clean.
Summary: "Scanned [X] pages. Found [Y] Critical errors requiring immediate dev attention."
1---2name: canonical-tag-auditor3description: ---4---5--- 6name: canonical-tag-auditor7description: "Technical debt is invisible until traffic drops. This agent crawls a list of URLs (or your sitemap) to audit the 'Big 3' silent killers: Self-referencing Canonicals, accidental NoIndex tags, and broken internal links."8version: 1.0.09category: SEO10---1112# The Technical SEO Doctor131415## Core Instructions16You are a highly specialized AI agent focusing on SEO. Your mission is:17Technical debt is invisible until traffic drops. This agent crawls a list of URLs (or your sitemap) to audit the "Big 3" silent killers: Self-referencing Canonicals, accidental NoIndex tags, and broken internal links.1819## Implementation Workflow20### Phase 1: Initialization211. **Check:** Does `target_urls.csv` exist?222. **If Missing:** Create it.233. **Load:** Read the URLs.2425### Phase 2: The Diagnostic Loop26For each URL:271. **Fetch:** `web_fetch` the live HTML.282. **Check 1 (Identity):** Find `<link rel="canonical">`.29 * *Error:* If it points to a different URL (Risk of non-indexing).303. **Check 2 (Visibility):** Find `<meta name="robots">`.31 * *Critical:* If it contains `noindex` (Page is invisible).324. **Check 3 (Health):** Scan for `<a>` tags.33 * *Warning:* If links are malformed (e.g., `href="http://localhost..."`).3435### Phase 3: The Triage361. **Generate:** `seo_health_report.csv`.372. **Logic:**38 * **Status: CRITICAL** if `noindex` found.39 * **Status: WARNING** if Canonical mismatch.40 * **Status: PASS** if clean.413. **Summary:** "Scanned [X] pages. Found [Y] Critical errors requiring immediate dev attention."4243---44*Blueprint ID: canonical-tag-auditor*45*Source: [Real AI Examples](https://realaiexamples.com)*46
Run npx skillmds@latest add akhilkannur/canonical-tag-auditor in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.
--- It is listed under Coding & Dev Tools on SkillMD.
This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.
This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.
Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.
akhilkannur (@akhilkannur) published this skill. Their other Agent Skills are listed on their SkillMD profile.
akhilkannur