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
Ready-to-paste message
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-auditorOr 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.mdTechnical 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
hreflangtags 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.
Popularity
- GitHub stars
- 48k
- Ranking position
- #3332
- License
- MIT
- Updated
- 10/15/2026
Comments
- …
More skills from this repository
00-andruia-consultant
Helps your agent start or improve AI projects. It analyzes code, suggests tools, and creates action plans in Spanish.
sickn33/agentic-awesome-skills
007
Lets your agent perform security audits and threat modeling. It's useful for protecting projects against attacks and vulnerabilities.
sickn33/agentic-awesome-skills
10-andruia-skill-smith
Helps your agent create or improve AI tools. It defines how tools work, writes documentation, and validates the structure.
sickn33/agentic-awesome-skills
20-andruia-niche-intelligence
Lets your agent create a summary about a specific industry. It's useful for understanding the context, rules, usage patterns, and risks of a project, using reliable sources.
sickn33/agentic-awesome-skills
Similar skills
competitive-platform-analysis
Helps understand your competitors. It identifies, categorizes, and filters competing companies before any deeper analysis.
affaan-m/ECC
competitive-report-structure
Creates comprehensive competitor reports. It combines information to show the overall landscape, recommendations, and helps align the team.
affaan-m/ECC
lead-intelligence
Helps your agent find and contact important people. It analyzes leads, suggests approaches, and manages outreach via email and social media.
affaan-m/ECC