seo

SEO: Universal SEO Analysis Skill

Invocation: /seo $1 $2 where $1 is the command and $2 is the URL or argument.

Scripts: Located at the plugin root scripts/ directory.

Comprehensive SEO analysis across all industries (SaaS, local services,

e-commerce, publishers, agencies). Orchestrates 16 specialized sub-skills and 11 subagents

(+ 3 optional extension sub-skills: seo-dataforseo, seo-firecrawl, and seo-image-gen).

Quick Reference

| Command | What it does |

|---------|-------------|

| /seo audit <url> | Full website audit with parallel subagent delegation |

| /seo page <url> | Deep single-page analysis |

| /seo sitemap <url or generate> | Analyze or generate XML sitemaps |

| /seo schema <url> | Detect, validate, and generate Schema.org markup |

| /seo images <url> | Image optimization analysis |

| /seo technical <url> | Technical SEO audit (9 categories) |

| /seo content <url> | E-E-A-T and content quality analysis |

| /seo geo <url> | AI Overviews / Generative Engine Optimization |

| /seo plan <business-type> | Strategic SEO planning |

| /seo programmatic [url\|plan] | Programmatic SEO analysis and planning |

| /seo competitor-pages [url\|generate] | Competitor comparison page generation |

| /seo local <url> | Local SEO analysis (GBP, citations, reviews, map pack) |

| /seo maps [command] [args] | Maps intelligence (geo-grid, GBP audit, reviews, competitors) |

| /seo hreflang [url] | Hreflang/i18n SEO audit and generation |

| /seo google [command] [url] | Google SEO APIs (GSC, PageSpeed, CrUX, Indexing, GA4) |

| /seo backlinks <url> | Backlink profile analysis (free: Moz, Bing, CC; premium: DataForSEO) |

| /seo firecrawl [command] <url> | Full-site crawling and site mapping (extension) |

| /seo dataforseo [command] | Live SEO data via DataForSEO (extension) |

| /seo image-gen [use-case] <description> | AI image generation for SEO assets (extension) |

Orchestration Logic

When the user invokes /seo audit, delegate to subagents in parallel:

1. Detect business type (SaaS, local, ecommerce, publisher, agency, other)
2. Spawn subagents: seo-technical, seo-content, seo-schema, seo-sitemap, seo-performance, seo-visual, seo-geo
3. If Google API credentials detected (python scripts/google_auth.py --check), also spawn seo-google agent
4. If local business detected, also spawn seo-local agent
5. If local business detected AND DataForSEO MCP available, also spawn seo-maps agent
6. If backlink APIs detected (python scripts/backlinks_auth.py --check), also spawn seo-backlinks agent
7. If Firecrawl MCP available, use firecrawl_map to discover all site URLs before analysis
8. Collect results and generate unified report with SEO Health Score (0-100)
9. Create prioritized action plan (Critical -> High -> Medium -> Low)
10. Offer PDF report: "Generate a professional PDF report? Use /seo google report full"

For individual commands, load the relevant sub-skill directly.

After any analysis command completes, offer to generate a PDF report via scripts/google_report.py.

Industry Detection

Detect business type from homepage signals:

• SaaS: pricing page, /features, /integrations, /docs, "free trial", "sign up"
• Local Service: phone number, address, service area, "serving [city]", Google Maps embed --> auto-suggest /seo local for deeper analysis
• E-commerce: /products, /collections, /cart, "add to cart", product schema
• Publisher: /blog, /articles, /topics, article schema, author pages, publication dates
• Agency: /case-studies, /portfolio, /industries, "our work", client logos

Quality Gates

Read references/quality-gates.md for thin content thresholds per page type.

Hard rules:

• WARNING at 30+ location pages (enforce 60%+ unique content)
• HARD STOP at 50+ location pages (require user justification)
• Never recommend HowTo schema (deprecated Sept 2023)
• FAQ schema for Google rich results: only government and healthcare sites (Aug 2023 restriction); existing FAQPage on commercial sites -> flag Info priority (not Critical), noting AI/LLM citation benefit; adding new FAQPage -> not recommended for Google benefit
• All Core Web Vitals references use INP, never FID

Reference Files

Load these on-demand as needed (do NOT load all at startup):

• references/cwv-thresholds.md: Current Core Web Vitals thresholds and measurement details
• references/schema-types.md: All supported schema types with deprecation status
• references/eeat-framework.md: E-E-A-T evaluation criteria (Sept 2025 QRG update)
• references/quality-gates.md: Content length minimums, uniqueness thresholds
• references/local-seo-signals.md: Local ranking factors, review benchmarks, citation tiers, GBP status
• references/local-schema-types.md: LocalBusiness subtypes, industry-specific schema and citation sources

Maps-specific references (loaded by seo-maps skill, not at startup):

• references/maps-geo-grid.md, references/maps-gbp-checklist.md, references/maps-api-endpoints.md, references/maps-free-apis.md

Scoring Methodology

SEO Health Score (0-100)

Weighted aggregate of all categories:

| Category | Weight |

|----------|--------|

| Technical SEO | 22% |

| Content Quality | 23% |

| On-Page SEO | 20% |

| Schema / Structured Data | 10% |

| Performance (CWV) | 10% |

| AI Search Readiness | 10% |

| Images | 5% |

Priority Levels

• Critical: Blocks indexing or causes penalties (immediate fix required)
• High: Significantly impacts rankings (fix within 1 week)
• Medium: Optimization opportunity (fix within 1 month)
• Low: Nice to have (backlog)

Sub-Skills

This skill orchestrates 15 specialized sub-skills (+ 2 extensions):

1. seo-audit -- Full website audit with parallel delegation
2. seo-page -- Deep single-page analysis
3. seo-technical -- Technical SEO (9 categories)
4. seo-content -- E-E-A-T and content quality
5. seo-schema -- Schema markup detection and generation
6. seo-images -- Image optimization
7. seo-sitemap -- Sitemap analysis and generation
8. seo-geo -- AI Overviews / GEO optimization
9. seo-plan -- Strategic planning with templates
10. seo-programmatic -- Programmatic SEO analysis and planning
11. seo-competitor-pages -- Competitor comparison page generation
12. seo-hreflang -- Hreflang/i18n SEO audit and generation
13. seo-local -- Local SEO (GBP, NAP, citations, reviews, local schema, multi-location)
14. seo-maps -- Maps intelligence (geo-grid, GBP audit, reviews, competitor radius)
15. seo-google -- Google SEO APIs (GSC, PageSpeed, CrUX, Indexing API, GA4)
16. seo-backlinks -- Backlink profile analysis (free: Moz, Bing, CC; premium: DataForSEO)
17. seo-firecrawl -- Full-site crawling and site mapping via Firecrawl MCP (extension)
18. seo-dataforseo -- Live SEO data via DataForSEO MCP (extension)
19. seo-image-gen -- AI image generation for SEO assets via Gemini (extension)

Subagents

For parallel analysis during audits:

• seo-technical -- Crawlability, indexability, security, CWV
• seo-content -- E-E-A-T, readability, thin content
• seo-schema -- Detection, validation, generation
• seo-sitemap -- Structure, coverage, quality gates
• seo-performance -- Core Web Vitals measurement
• seo-visual -- Screenshots, mobile testing, above-fold
• seo-geo -- AI crawler access, llms.txt, citability, brand mention signals
• seo-local -- GBP signals, NAP consistency, reviews, local schema, industry-specific local factors (conditional: spawned when Local Service detected)
• seo-maps -- Geo-grid rank tracking, GBP audit, review intelligence, competitor radius mapping (conditional: spawned when Local Service detected AND DataForSEO MCP available)
• seo-google -- CWV field data, URL indexation status, organic traffic trends (conditional: spawned when Google API credentials detected)
• seo-backlinks -- Backlink profile data: DA/PA, referring domains, anchor text, toxic links (conditional: spawned when Moz/Bing API keys detected or always for CC domain-level metrics)
• seo-dataforseo -- Live SERP, keyword, backlink, local SEO data (extension, optional)
• seo-image-gen -- SEO image audit and generation plan (extension, optional)
• seo-firecrawl -- Full-site crawl and site mapping (extension, optional; used by audit for URL discovery)

Error Handling

| Scenario | Action |

|----------|--------|

| Unrecognized command | List available commands from the Quick Reference table. Suggest the closest matching command. |

| URL unreachable | Report the error and suggest the user verify the URL. Do not attempt to guess site content. |

| Sub-skill fails during audit | Report partial results from successful sub-skills. Clearly note which sub-skill failed and why. Suggest re-running the failed sub-skill individually. |

| Ambiguous business type detection | Present the top two detected types with supporting signals. Ask the user to confirm before proceeding with industry-specific recommendations. |