SEO: Universal SEO Analysis Skill
Comprehensive SEO analysis across all industries (SaaS, local services,
e-commerce, publishers, agencies). Orchestrates 12 specialized sub-skills and 7 subagents
(+ optional extension sub-skills like seo-dataforseo).
When to Use
- Use when the user asks for a full SEO audit or broad SEO strategy.
- Use as the umbrella entry point when multiple SEO dimensions are in scope.
- Use when the task spans technical SEO, content, schema, sitemaps, and AI search readiness together.
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 hreflang [url] |
Hreflang/i18n SEO audit and generation |
/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:
- Detect business type (SaaS, local, ecommerce, publisher, agency, other)
- Spawn subagents: seo-technical, seo-content, seo-schema, seo-sitemap, seo-performance, seo-visual, seo-geo
- 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 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 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 thresholds
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 12 specialized sub-skills (+ 2 extensions):
- seo-audit -- Full website audit with parallel delegation
- seo-page -- Deep single-page analysis
- seo-technical -- Technical SEO (9 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-dataforseo -- Live SEO data via DataForSEO MCP (extension)
- seo-image-gen -- AI image generation for SEO assets via Gemini (extension)
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-geo -- AI crawler access, llms.txt, citability, brand mention signalsseo-dataforseo -- Live SERP, keyword, backlink, local SEO data (extension, optional)seo-image-gen -- SEO image audit and generation plan (extension, optional)
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. |
Limitations
- Use this skill only when the task clearly matches the scope described above.
- Do not treat the output as a substitute for environment-specific validation, testing, or expert review.
- Stop and ask for clarification if required inputs, permissions, safety boundaries, or success criteria are missing.
1---2name: seo3description: Run a broad SEO audit across technical SEO, on-page SEO, schema, sitemaps, content quality, AI search readiness, and GEO. Use as the umbrella skill when the user asks for a full SEO analysis or strategy.4---56# SEO: Universal SEO Analysis Skill78Comprehensive SEO analysis across all industries (SaaS, local services,9e-commerce, publishers, agencies). Orchestrates 12 specialized sub-skills and 7 subagents10(+ optional extension sub-skills like seo-dataforseo).1112## When to Use13- Use when the user asks for a full SEO audit or broad SEO strategy.14- Use as the umbrella entry point when multiple SEO dimensions are in scope.15- Use when the task spans technical SEO, content, schema, sitemaps, and AI search readiness together.1617## Quick Reference1819| Command | What it does |20|---------|-------------|21| `/seo audit <url>` | Full website audit with parallel subagent delegation |22| `/seo page <url>` | Deep single-page analysis |23| `/seo sitemap <url or generate>` | Analyze or generate XML sitemaps |24| `/seo schema <url>` | Detect, validate, and generate Schema.org markup |25| `/seo images <url>` | Image optimization analysis |26| `/seo technical <url>` | Technical SEO audit (9 categories) |27| `/seo content <url>` | E-E-A-T and content quality analysis |28| `/seo geo <url>` | AI Overviews / Generative Engine Optimization |29| `/seo plan <business-type>` | Strategic SEO planning |30| `/seo programmatic [url\|plan]` | Programmatic SEO analysis and planning |31| `/seo competitor-pages [url\|generate]` | Competitor comparison page generation |32| `/seo hreflang [url]` | Hreflang/i18n SEO audit and generation |33| `/seo dataforseo [command]` | Live SEO data via DataForSEO (extension) |34| `/seo image-gen [use-case] <description>` | AI image generation for SEO assets (extension) |3536## Orchestration Logic3738When the user invokes `/seo audit`, delegate to subagents in parallel:391. Detect business type (SaaS, local, ecommerce, publisher, agency, other)402. Spawn subagents: seo-technical, seo-content, seo-schema, seo-sitemap, seo-performance, seo-visual, seo-geo413. Collect results and generate unified report with SEO Health Score (0-100)424. Create prioritized action plan (Critical -> High -> Medium -> Low)4344For individual commands, load the relevant sub-skill directly.4546## Industry Detection4748Detect business type from homepage signals:49- **SaaS**: pricing page, /features, /integrations, /docs, "free trial", "sign up"50- **Local Service**: phone number, address, service area, "serving [city]", Google Maps embed51- **E-commerce**: /products, /collections, /cart, "add to cart", product schema52- **Publisher**: /blog, /articles, /topics, article schema, author pages, publication dates53- **Agency**: /case-studies, /portfolio, /industries, "our work", client logos5455## Quality Gates5657Read `references/quality-gates.md` for thin content thresholds per page type.58Hard rules:59- WARNING at 30+ location pages (enforce 60%+ unique content)60- HARD STOP at 50+ location pages (require user justification)61- Never recommend HowTo schema (deprecated Sept 2023)62- 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 benefit63- All Core Web Vitals references use INP, never FID6465## Reference Files6667Load these on-demand as needed (do NOT load all at startup):68- `references/cwv-thresholds.md`: Current Core Web Vitals thresholds and measurement details69- `references/schema-types.md`: All supported schema types with deprecation status70- `references/eeat-framework.md`: E-E-A-T evaluation criteria (Sept 2025 QRG update)71- `references/quality-gates.md`: Content length minimums, uniqueness thresholds7273## Scoring Methodology7475### SEO Health Score (0-100)76Weighted aggregate of all categories:7778| Category | Weight |79|----------|--------|80| Technical SEO | 22% |81| Content Quality | 23% |82| On-Page SEO | 20% |83| Schema / Structured Data | 10% |84| Performance (CWV) | 10% |85| AI Search Readiness | 10% |86| Images | 5% |8788### Priority Levels89- **Critical**: Blocks indexing or causes penalties (immediate fix required)90- **High**: Significantly impacts rankings (fix within 1 week)91- **Medium**: Optimization opportunity (fix within 1 month)92- **Low**: Nice to have (backlog)9394## Sub-Skills9596This skill orchestrates 12 specialized sub-skills (+ 2 extensions):97981. **seo-audit** -- Full website audit with parallel delegation992. **seo-page** -- Deep single-page analysis1003. **seo-technical** -- Technical SEO (9 categories)1014. **seo-content** -- E-E-A-T and content quality1025. **seo-schema** -- Schema markup detection and generation1036. **seo-images** -- Image optimization1047. **seo-sitemap** -- Sitemap analysis and generation1058. **seo-geo** -- AI Overviews / GEO optimization1069. **seo-plan** -- Strategic planning with templates10710. **seo-programmatic** -- Programmatic SEO analysis and planning10811. **seo-competitor-pages** -- Competitor comparison page generation10912. **seo-hreflang** -- Hreflang/i18n SEO audit and generation11013. **seo-dataforseo** -- Live SEO data via DataForSEO MCP (extension)11114. **seo-image-gen** -- AI image generation for SEO assets via Gemini (extension)112113## Subagents114115For parallel analysis during audits:116- `seo-technical` -- Crawlability, indexability, security, CWV117- `seo-content` -- E-E-A-T, readability, thin content118- `seo-schema` -- Detection, validation, generation119- `seo-sitemap` -- Structure, coverage, quality gates120- `seo-performance` -- Core Web Vitals measurement121- `seo-visual` -- Screenshots, mobile testing, above-fold122- `seo-geo` -- AI crawler access, llms.txt, citability, brand mention signals123- `seo-dataforseo` -- Live SERP, keyword, backlink, local SEO data (extension, optional)124- `seo-image-gen` -- SEO image audit and generation plan (extension, optional)125126## Error Handling127128| Scenario | Action |129|----------|--------|130| Unrecognized command | List available commands from the Quick Reference table. Suggest the closest matching command. |131| URL unreachable | Report the error and suggest the user verify the URL. Do not attempt to guess site content. |132| 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. |133| Ambiguous business type detection | Present the top two detected types with supporting signals. Ask the user to confirm before proceeding with industry-specific recommendations. |134135## Limitations136- Use this skill only when the task clearly matches the scope described above.137- Do not treat the output as a substitute for environment-specific validation, testing, or expert review.138- Stop and ask for clarification if required inputs, permissions, safety boundaries, or success criteria are missing.
bouclem