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

Quick Reference

Command

What it does

/seo audit

Full website audit with parallel subagent delegation

/seo page

Deep single-page analysis

/seo sitemap

Analyze or generate XML sitemaps

/seo schema

Detect, validate, and generate Schema.org markup

/seo images

Image optimization analysis

/seo technical

Technical SEO audit (9 categories)

/seo content

E-E-A-T and content quality analysis

/seo geo

AI Overviews / Generative Engine Optimization

/seo plan

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)

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

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 (+ 1 extension): 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) 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)