diagnose-seo

This skill provides a structured framework for diagnosing technical SEO issues that impact how search engines discover, access, and interpret web pages. It is designed to help users systematically break down complex visibility problems into clear, logical diagnostic layers instead of relying on assumptions or isolated checks. By organizing SEO troubleshooting into a consistent methodology, it ensures that foundational technical barriers are identified before evaluating higher-level optimization signals or content-related factors.

The skill is built around a four-layer diagnostic model covering crawlability, indexability, renderability, and search signals. It evaluates critical technical elements such as robots.txt rules that may unintentionally block search engines, XML sitemaps for completeness and accuracy, and site architecture issues like orphan pages, redirect chains, and excessive crawl depth. It also inspects server responses including HTTP status codes, redirect behavior, soft 404s, and HTTPS enforcement. For indexability, it analyzes meta robots directives, X-Robots-Tag headers, canonical tag correctness, and duplicate content across URL variations. Renderability checks focus on JavaScript-driven content, ensuring search engines can access full page content, and verifying whether key information is present in initial HTML or only loaded dynamically. It also considers broader SEO signals such as titles, structured data, and internal linking consistency.

This skill is primarily used by SEO professionals, web developers, technical auditors, and content teams who need to investigate indexing drops, crawl inefficiencies, migration issues, or unexpected ranking changes. It is especially useful during site launches, redesigns, CMS migrations, or situations where pages fail to appear in search results despite being publicly available. It helps teams systematically identify whether issues stem from crawling restrictions, indexing rules, rendering limitations, or missing technical SEO signals, enabling more accurate troubleshooting and prioritization of fixes.