SEO

SEO: Universal SEO Analysis Skill

Selective Reading Rule

Start with:

• references/usage-routing.md
• references/quality-checklist.md

Then load only the inherited docs, scripts, assets, or examples that match the user's actual task.

Selective Reading Rule

Start with:

• references/senior-master-standard.md

Then load only the references, scripts, assets, or examples needed for the user's actual task.

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

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. Collect results and generate unified report with SEO Health Score (0-100)
4. 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 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:

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):

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-dataforseo -- Live SEO data via DataForSEO MCP (extension)
14. 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-dataforseo -- Live SERP, keyword, backlink, local SEO data (extension, optional)
• seo-image-gen -- SEO image audit and generation plan (extension, optional)

Error Handling

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.