/seo

name: seo
description: "Comprehensive SEO analysis for any website, page, business, or topic. Full site audits, SEO checks, single-page analysis, technical SEO (crawlability, indexability, Core Web Vitals with INP), schema markup, content quality (E-E-A-T), image optimization, sitemap analysis, GEO for AI Overviews/ChatGPT/Perplexity, and SEO best-practice planning. Industry detection for SaaS, e-commerce, local, publishers, agencies. Triggers on: SEO, audit, full SEO check, SEO best practices, optimize my site, ranking, organic search, schema, Core Web Vitals, sitemap, E-E-A-T, AI Overviews, GEO, technical SEO, content quality, page speed, structured data."
user-invokable: true
argument-hint: "[command] [url]"
license: MIT
metadata:
  author: AgriciDaniel
  version: "1.9.6"
  category: seo

SEO: Universal SEO Analysis Skill

Codex can invoke this skill from natural language ("audit this site", "check schema", "run a technical SEO review") or from command-like prompts such as `/seo audit <url>`. Use the matching specialist skill directly when the request is narrow.

**Scripts:** Located at the plugin root `scripts/` directory.

Comprehensive SEO analysis across all industries (SaaS, local services, e-commerce, publishers, agencies). Orchestrates 26 specialized sub-skills and 24 Codex agent profiles, with optional MCP-backed extensions for DataForSEO, Firecrawl, and image generation.

Shared Data Cache

**Step 0 -- Check shared data cache:**

Before routing or gathering, check `.seo-cache/` for cached data from other skills. Reference: `references/shared-data-cache.md` for schemas and dependency map.

Check these cache files when present:

• `.seo-cache/site-meta.json` for domain, business type, industry, and crawl context
• `.seo-cache/audit-scores.json` for audit summary context from a prior full audit
• `.seo-cache/pages/{url-slug}/page-analysis.json` for page-level specialist context

• If found: parse and use the data (note "Using cached [X] from [date]")
• If missing: proceed without it (note "No cached [X] found, gathering fresh")
• If JSON is corrupt or unreadable: treat it as missing and continue normally
• If the user says "refresh" or "re-run": ignore cache entirely

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 or optimize>` | Image SEO: on-page audit, SERP analysis, file optimization | | `/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 cluster <seed-keyword>` | SERP-based semantic clustering and content architecture | | `/seo sxo <url>` | Search Experience Optimization: page-type analysis, user stories, personas | | `/seo drift baseline <url>` | Capture SEO baseline for change monitoring | | `/seo drift compare <url>` | Compare current state to stored baseline | | `/seo drift history <url>` | Show drift history over time | | `/seo ecommerce <url>` | E-commerce SEO: product schema, marketplace intelligence | | `/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) | | `/seo flow [stage] [url\|topic]` | FLOW framework: evidence-led prompts for Find, Leverage, Optimize, Win, or Local stages |

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. If content strategy signals detected (blog, pillar pages, topic clusters), also spawn seo-cluster agent 9. If e-commerce detected, also spawn seo-ecommerce agent 10. If drift baseline exists for this URL (`python scripts/drift_history.py <url>`), also spawn seo-drift agent 11. Always include seo-sxo in full audits (search experience applies to all sites) 12. Collect results and generate unified report with SEO Health Score (0-100) 13. Create prioritized action plan (Critical -> High -> Medium -> Low) 14. **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, /