Skip to content
Skillpedia
SEO48k · #3332

indexing-issue-auditor

Lets your agent check a website's health for SEO. It looks for problems that affect how Google finds and understands your site.

What it does

This tool analyzes your website to find issues that prevent Google from discovering and displaying it in search results. It checks if pages are accessible, links work correctly, and the site's structure is organized.

When to use it

  • ✓When many of your site's pages aren't appearing in Google.
  • ✓When planning a new site structure or redesigning an existing one.
  • ✓To check if Google can 'read' and understand your site correctly.

Example of what to ask your AI

“Analyze my website [website address] for indexing issues and architecture optimization.”

Want more? Open the sections below.

How to use

The easiest way: copy the message below and paste it into Claude, ChatGPT, Cursor or any AI. It reads the skill and follows the instructions.

Skill link

https://github.com/sickn33/agentic-awesome-skills/blob/main/plugins/agentic-awesome-skills-claude/skills/indexing-issue-auditor/SKILL.md

Ready-to-paste message

Use this skill to help me: https://github.com/sickn33/agentic-awesome-skills/blob/main/plugins/agentic-awesome-skills-claude/skills/indexing-issue-auditor/SKILL.md Read the SKILL.md file at that link and follow its instructions for my task.
How it works

The tool examines how Google visits and understands your site, checking links, sitemaps, and the overall structure. It proposes a plan to fix issues and improve how Google sees your site.

Installation

Easiest way: copy the skill link and paste it into Claude, ChatGPT or Cursor asking it to follow the instructions.

In the terminal (Claude Code, Codex, Cursor), in your project folder:

npx skills add sickn33/agentic-awesome-skills --skill indexing-issue-auditor

Or download just the file:

curl -L https://raw.githubusercontent.com/sickn33/agentic-awesome-skills/main/plugins/agentic-awesome-skills-claude/skills/indexing-issue-auditor/SKILL.md -o SKILL.md
Technical content (original SKILL.md)

Original text by the author, straight from GitHub.

Indexing Issue Auditor & Technical SEO Architect

Overview

Act as a Senior Technical SEO Architect, Web Infrastructure Engineer, and Site Reliability Auditor. Your objective is to perform a deep-dive scan of a website's architecture to identify, diagnose, and fix crawl health issues, indexing blocks, and structural SEO failures.

Your job is NOT just to find issues — your goal is to design and rebuild the site's architecture into a fully optimized system that Google fully trusts.

When to Use This Skill

  • Use when preparing or auditing a site for Google Search Console health.
  • Use when encountering "Discovered but not currently indexed" or other mass indexing errors.
  • Use to audit Sitemaps, Robots.txt, and URL structures for crawl budget waste.
  • Use when designing a New Site Architecture or performing a content silo migration.
  • Use to perform a Site Reliability Audit specifically focused on SEO stability and redirect integrity.

Input Types

  • Directory Path: Scanning local folder structures for sitemap.xml, robots.txt, and canonical logic in templates.
  • Search Console Reports: Analyzing exported CSVs of indexing errors (404s, Soft 404s, Redirect loops).
  • Public Domain URL: Performing a live scan of architectural signals (Crawl depth, response codes).
  • Architecture Drafts: Evaluating proposed URL structures or internal linking maps before deployment.

How It Works (Mandatory Phases)

You must scan and audit in this exact order:

Phase 1: Indexing System Health

Detect 404s, "Crawled but not indexed", "Soft 404s", and noindex tags. Explain why Google rejected indexing and define if the issue is Content, Technical, or Structural.

Phase 2: Crawl Architecture

Analyze crawl depth, identify orphan pages, and map the internal linking graph to find crawl budget waste.

Phase 3: Sitemap Architecture Audit

Validate that sitemaps contain ONLY indexable URLs (no redirects, no 404s). Segment sitemaps by type (pages/posts/products) and ensure canonical alignment.

  • Internationalization: Validate that hreflang tags have correct return links and match the sitemap entries for multi-region setups.

Phase 4: URL Architecture Design

Identify URL duplication patterns and parameter-heavy URLs. Propose a "Clean URL Architecture Model."

Phase 5: Redirect & Link Flow

Identify redirect chains and loops. Map the flow of internal link equity and propose a "Clean Redirect Flow Map."

Phase 6: Content Quality Engine

Detect thin pages, duplicate clusters, and auto-generated content. Propose a consolidation plan.

Phase 7: Technical Server Health

Check for 5xx errors, 403 blocks, and API failures affecting crawler stability.

  • SSR & Hydration: Verify if Googlebot is seeing the same content as users in JavaScript-heavy environments (Next.js/Nuxt). Detect if "hidden" content requires client-side hydration that Google cannot complete.

Phase 8: Performance & Resource Loading

Audit render-blocking JS, CSS delays, and lazy loading errors from a structural perspective.

Phase 9: Internal Linking System Design

Redesign the internal linking graph into a topical SEO Silo (Hub and Spoke) model.

Phase 10: Final Rebuild Plan

Produce a step-by-step cleanup order and an SEO stabilization roadmap (Day 1 → Day 30).

Master Issue Control Table

For every audit, you MUST generate a table in this exact format:

# Issue Layer (SEO/Crawl/Server/Content) Affected URLs/Patterns Root Cause Fix (Technical) Fix (Structural) Priority Status
1 Redirect Loop Server /blog/old-post Nested .htaccess rule Flatten to 1-hop Redesign routing High Open

Examples

Example 1: Local Directory Audit

Input: Root directory of a static site project. Scan Result: Detected a robots.txt blocking /public/static but missing an entry for the /api route. Fix: Added Disallow: /api/* and verified sitemap.xml includes only the /app/ routes.

Example 2: Indexing Reversal

Input: GSC Report showing 40% "Crawled - currently not indexed". Diagnosis: Architectural duplication (Parameter-based vs. Static URLs). Fix: Implemented strict Canonicalization and parameterized URL handling in robots.txt.

Best Practices

  • ✅ Provide FIX + STRUCTURAL DESIGN: Do not just report; provide the technical fix and the architectural redesign.

…

FAQ

What are 'indexing issues'?

These are errors that prevent Google from adding your pages to its index, meaning they won't show up in search results.

What is 'crawl budget'?

It's the amount of resources Google dedicates to crawling your site. If the site has too many broken links or unnecessary pages, Google might spend this 'budget' on the wrong things and miss important content.

Does the tool fix the problems automatically?

No, the tool identifies the issues and suggests fixes and an action plan. You or a developer will need to implement the changes.

Details

Original description by the author

High-level technical SEO and site architecture auditor. Invoke to scan local or live environments for indexing, crawl budget, and structural errors.

repo: sickn33/agentic-awesome-skills

Popularity

GitHub stars
48k
Ranking position
#3332
License
MIT
Updated
10/15/2026

Is this skill useful?

0

Sign in to vote.

Comments

  • …

More skills from this repository

Similar skills