The diagnose-seo skill provides a structured diagnostic framework for identifying and troubleshooting technical SEO problems, organized across four sequential layers: crawlability, indexability, renderability, and signals. It's designed for SEO professionals, developers, and site owners who need to systematically diagnose why pages aren't being indexed, fix crawl issues, resolve canonicalization errors, or troubleshoot robots.txt and sitemap problems. The skill solves the problem of scattered, non-systematic SEO troubleshooting by offering a layered approach that checks each dependency in order, starting with whether search engines can access pages before diagnosing indexation and rendering issues.

skills.sh installs
2.2K
GitHub stars
21
last updated
Aug 21, 2026

Install

$ npx -y skills add calm-north/seojuice-skills --skill diagnose-seo --agent claude-code

Installs into .claude/skills of the current project.

Files

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:

  1. Crawlability — Can search engines find and access the pages?
  2. Indexability — Are the pages allowed to be indexed?
  3. Renderability — Can search engines see the full content?
  4. Signals — Are the right signals (titles, structured data, links) in place?

Layer 1: Crawlability

Check these in order:

robots.txt

  • Fetch [domain]/robots.txt and review the rules
  • Look for overly broad Disallow rules blocking important paths
  • Verify Sitemap: directive points to the correct sitemap URL
  • Check for different rules per user-agent (Googlebot vs others)

Common mistakes:

  • Disallow: / blocking the entire site (often left from staging)
  • Blocking CSS/JS files that Googlebot needs for rendering
  • Blocking API or AJAX endpoints that load dynamic content
  • Staging robots.txt accidentally deployed to production

Sponsors

Details

Repository
github.com/calm-north/seojuice-skills
Categories
Debugging, Marketing & SEO

More from calm-north/seojuice-skills

All 14

Recommended

More Debugging
1nvidia avatardynamo-troubleshootnvidia/skillsDiagnose failed or unhealthy Dynamo deployments. Use when pods, model-cache jobs, PVCs, workers, frontend/router health, endpoints, or benchmark jobs fail; use 1.9Kskills.sh installs
2lobehub avatardebuglobehub/lobehubDebug package usage guide. Use when adding debug logging, understanding log namespaces, or implementing debugging features. Triggers on debug logging requests o1.5Kskills.sh installs
3cap-go avatardebugging-capacitorcap-go/capgo-skillsComprehensive debugging guide for Capacitor applications. Covers WebView debugging, native debugging, crash analysis, network inspection, and common issues. Use1.4Kskills.sh installs
4tursodatabase avatardebuggingtursodatabase/tursoHow to debug tursodb using Bytecode comparison, logging, ThreadSanitizer, deterministic simulation, and corruption analysis tools1.3Kskills.sh installs
5cap-go avatarcapacitor-performancecap-go/capgo-skillsPerformance optimization guide for Capacitor apps covering bundle size, rendering, memory, native bridge, and profiling. Use this skill when users need to optim1.3Kskills.sh installs
6astronomer avatardebugging-dagsastronomer/agentsComprehensive DAG failure diagnosis and root-cause analysis with structured investigation and prevention recommendations. Use when deep failure investigation is1.2Kskills.sh installs