Seo

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

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

1. seo-audit — Full website audit with parallel delegation
2. seo-page — Deep single-page analysis
3. seo-technical — Technical SEO (8 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

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

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: realyticai
• Source: realyticai/claude-seo
• License: MIT

Install and usage instructions live in the source repository linked above.