diagnose-seo
This skill helps you uncover why search engines aren't crawling or indexing your web pages. It analyzes technical SEO barriers—robots.txt rules, meta tags, redirects, and server responses—to pinpoint exactly what's preventing visibility. Use it to troubleshoot indexation roadblocks and get your content discoverable again.
diagnose-seo helps you uncover indexation barriers by analyzing technical SEO factors like robots.txt rules, meta tags, redirects, and server responses. The skill pinpoints what's preventing search engines from crawling or indexing your pages, then guides you toward fixes so your content becomes discoverable again.
AI-generated summary based on this skill's SKILL.md
Install
calm-north/seojuice-skills/diagnose-seo
git clone https://github.com/calm-north/seojuice-skills
cp -r seojuice-skills/skills/diagnose-seo ~/.claude/skills/diagnose-seoFrequently asked questions
AI-generated answers based on this skill's SKILL.md and metadata
Why isn't my website being indexed by Google?
diagnose-seo helps you uncover indexation barriers by analyzing technical SEO factors like robots.txt rules, meta tags, redirects, and server responses. The skill pinpoints what's preventing search engines from crawling or indexing your pages, then guides you toward fixes so your content becomes discoverable again.
How do I fix robots.txt blocking my pages from search?
diagnose-seo identifies robots.txt configuration errors that may be accidentally blocking crawlers. It analyzes your rules against your actual site structure, detects overly restrictive directives, and helps you reconfigure them to allow search engine access while maintaining security where needed.
What causes canonical tag errors and how do I diagnose them?
diagnose-seo detects canonical tag mistakes—missing tags, self-referential loops, or pointing to wrong URLs—that confuse search engines about which version to index. It validates your canonical setup across pages and explains how errors harm SEO, then recommends corrections.
How can I check if search engines can crawl my site?
diagnose-seo audits your site's crawlability by testing page renderability, checking server responses, validating sitemaps, and scanning for redirect chains or soft 404 errors. It reveals exactly which technical barriers prevent search engine access and what to fix first.
What technical SEO problems affect my search visibility most?
diagnose-seo troubleshoots the highest-impact issues: robots.txt misconfigurations, meta robots noindex tags accidentally applied, duplicate content via missing canonicals, broken redirects, and rendering problems. It prioritizes fixes by their effect on indexation and search rankings.
How do I validate my sitemap and on-page SEO signals?
diagnose-seo checks whether your sitemap is properly formatted, accessible to crawlers, and contains valid URLs. It also validates on-page signals like heading hierarchy, title tags, structured data, and hreflang tags for multilingual sites—all critical for search engine understanding.
SKILL.md
rendered from the published skill — quoted content, verbatim
Diagnose SEO
Structured diagnostic framework for crawl issues, canonicalization errors, indexation problems, and rendering failures.
Diagnostic Approach
Technical SEO problems fall into four categories. Diagnose in this order — each layer depends on the previous one working correctly:
- Crawlability — Can search engines find and access the pages?
- Indexability — Are the pages allowed to be indexed?
- Renderability — Can search engines see the full content?
- Signals — Are the right signals (titles, structured data, links) in place?
Layer 1: Crawlability
Check these in order:
robots.txt
- Fetch
[domain]/robots.txtand review the rules - Look for overly broad
Disallowrules blocking important paths - Verify
Sitemap:directive points to the correct
(truncated - see the full file via the links below)
Read as markdown · JSON record · Browse the source repository
File tree — 1 file
skills/diagnose-seo/SKILL.md