SEO — Universal SEO Analysis Skill
Comprehensive SEO analysis across all industries (SaaS, local services, e-commerce, publishers, agencies). Orchestrates 25 specialized sub-skills and 15 subagents.
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 (8 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 hreflang [url] |
Hreflang/i18n SEO audit and generation |
/seo agent <url> |
Agent Engine Optimization (AEO) audit - MCP, OpenAPI, llms.txt, SDK |
/seo performance <url> |
Core Web Vitals + HTTP/3 + page performance analysis |
/seo visual <url> |
Visual analysis, screenshots, mobile rendering, Visual Search readiness |
/seo multiplatform <url> |
TikTok SEO + Visual Search + Reddit/Forum + Video SEO |
/seo data-tools <url> |
GSC API + GA4 + PageSpeed Insights + CrUX + third-party data tools |
/seo rank-tracker <keywords> |
Keyword ranking monitoring + SERP features + competitor tracking |
/seo content-brief <keyword> |
SERP-driven content brief generation with competitor gap analysis |
/seo backlinks <url> |
Backlink profile analysis + competitor link gap + outreach strategy |
/seo monitor <url> |
SEO monitoring dashboard + alerts + competitor activity tracking |
/seo report <url> |
Weekly/monthly/quarterly report generation + dashboard templates |
/seo keywords <topic> |
Keyword research + competitor gap + topic clusters + prioritization |
/seo competitors <url> |
Competitor SEO analysis + SWOT + keyword gap + strategy |
/seo local <business> |
Local SEO audit + GBP optimization + NAP + review management |
Orchestration Logic
When the user invokes /seo audit, delegate to subagents in parallel:
- Detect business type (SaaS, local, ecommerce, publisher, agency, other)
- Spawn subagents: seo-technical, seo-content, seo-schema, seo-sitemap, seo-performance, seo-visual
- Collect results and generate unified report with SEO Health Score (0-100)
- Create prioritized action plan (Critical → High → Medium → Low)
For individual commands, load the relevant sub-skill directly.
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
- 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 only for government and healthcare sites
- 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 detailsreferences/schema-types.md— All supported schema types with deprecation statusreferences/eeat-framework.md— E-E-A-T evaluation criteria (Sept 2025 QRG update)references/quality-gates.md— Content length minimums, uniqueness thresholdsreferences/mcp-quality.md— MCP manifest structure and tool description scoringreferences/agent-user-agents.md— Agent UA strings and robots.txt for agentsreferences/openapi-compliance.md— OpenAPI 3.1 spec requirements for agent integrationreferences/backlink-metrics.md— DR/DA/AS cross-reference, anchor text ratios, toxic link scoring, industry benchmarksreferences/keyword-difficulty.md— KD score interpretation, industry benchmarks, search intent guide, DataForSEO Keywords API
Scoring Methodology
SEO Health Score (0-100)
Weighted aggregate of all categories:
| Category | Weight |
|---|---|
| Technical SEO | 25% |
| Content Quality | 25% |
| On-Page SEO | 20% |
| Schema / Structured Data | 10% |
| Performance (CWV) | 10% |
| Images | 5% |
| AI Search Readiness | 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 25 specialized sub-skills:
- seo-audit — Full website audit with parallel delegation
- seo-page — Deep single-page analysis
- seo-technical — Technical SEO (8 categories)
- seo-content — E-E-A-T and content quality
- seo-schema — Schema markup detection and generation
- seo-images — Image optimization
- seo-sitemap — Sitemap analysis and generation
- seo-geo — AI Overviews / GEO optimization
- seo-plan — Strategic planning with templates
- seo-programmatic — Programmatic SEO analysis and planning
- seo-competitor-pages — Competitor comparison page generation
- seo-hreflang — Hreflang/i18n SEO audit and generation
- seo-agent — Agent Engine Optimization (AEO) audit
- seo-performance — Core Web Vitals and page performance analysis
- seo-visual — Visual analysis, screenshots, and mobile rendering
- seo-multiplatform — Multi-platform SEO (TikTok, Visual Search, Reddit, Video)
- seo-data-tools — GSC API, GA4, PageSpeed Insights, CrUX, third-party data
- seo-rank-tracker — Keyword ranking monitoring and SERP feature tracking
- seo-content-brief — SERP-driven content brief generation
- seo-backlinks — Backlink profile analysis, competitor link gap, outreach strategy
- seo-monitor — SEO monitoring, alerting, and competitor activity tracking
- seo-report — Weekly/monthly/quarterly report generation and dashboards
- seo-keyword-research — Keyword research, topic clustering, and prioritization
- seo-competitor-analysis — Comprehensive SEO competitive intelligence
- seo-local — Local SEO, Google Business Profile, NAP, reviews
Subagents
For parallel analysis during audits:
seo-technical— Crawlability, indexability, security, CWVseo-content— E-E-A-T, readability, thin contentseo-schema— Detection, validation, generationseo-sitemap— Structure, coverage, quality gatesseo-performance— Core Web Vitals measurementseo-visual— Screenshots, mobile testing, above-foldseo-data-tools— GSC/GA4/PSI data integrationseo-rank-tracker— Ranking and SERP feature trackingseo-content-brief— Content brief generationseo-backlinks— Backlink profile and competitor link gapseo-monitor— Ranking/competitor/technical monitoringseo-report— Report and dashboard generationseo-keyword-research— Keyword research and topic clusteringseo-competitor-analysis— SEO competitive intelligenceseo-local— Local SEO, GBP, NAP, reviews