indexing-issue-auditor
High-level technical SEO and site architecture auditor. Invoke to scan local or live environments for indexing, crawl budget, and structural errors.
Documentation
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.
- ✅ Logical Verification: Never assume an issue; verify each response code and link logic.
- ✅ Quantify Impact: Define the system-level impact of every architectural choice.
- ❌ No Fluff: Focus on actionable, engineering-level structured output.
Common Pitfalls
- Problem: Treating indexing issues as "content only" when they are often architectural.
- Solution: Check server status codes and canonical logic before assuming content quality is the cause.
- Problem: Ignoring "Crawl Depth" (pages bu
Use Cases
- 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.
Quick Info
- Source
- antigravity
- Category
- Security & Systems
- Repository
- View Repo
- Scraped At
- Apr 14, 2026
Tags
Related Skills
active-directory-attacks
Provide comprehensive techniques for attacking Microsoft Active Directory environments. Covers reconnaissance, credential harvesting, Kerberos attacks, lateral movement, privilege escalation, and domain dominance for red team operations and penetration testing.
agent-evaluation
Testing and benchmarking LLM agents including behavioral testing, capability assessment, reliability metrics, and production monitoring—where even top agents achieve less than 50% on real-world benchmarks
anti-reversing-techniques
AUTHORIZED USE ONLY: This skill contains dual-use security techniques. Before proceeding with any bypass or analysis: > 1.