SEO — Universal SEO Analysis Skill
Comprehensive SEO analysis across all industries (SaaS, local services, e-commerce, publishers, agencies). Orchestrates 12 specialized sub-skills and 6 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 |
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 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
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 12 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
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