SEO — Universal SEO Analysis Skill

Comprehensive SEO analysis across all industries (SaaS, local services, e-commerce, publishers, agencies). Orchestrates 44 specialized sub-skills (44 active) and 6 subagents.

Quick Reference

Active Commands (Phase 1 — Enhanced)

/seo audit <url>

/seo page <url>

/seo sitemap <url or generate>

/seo schema <url>

/seo images <url>

/seo technical <url>

/seo content <url>

/seo geo <url>

/seo plan <business-type>

/seo programmatic [url|plan]

/seo competitor-pages [url|generate]

/seo hreflang [url]

Active Commands (Phase 2 — Live MCP Data)

/seo gsc overview <site>

/seo gsc drops <site>

/seo gsc opportunities <site>

/seo gsc brand-vs-nonbrand <site>

/seo gsc cannibalization <site>

/seo gsc compare <site>

/seo gsc content-decay <site>

/seo gsc index-issues <site>

/seo gsc new-keywords <site>

/seo ahrefs overview <domain>

/seo ahrefs backlinks <domain>

/seo ahrefs keywords <domain>

/seo ahrefs competitors <domain>

/seo ahrefs content-gap <domain>

/seo ahrefs broken-links <domain>

/seo ahrefs new-links <domain>

/seo ahrefs anchor-analysis <domain>

/seo ahrefs dr-history <domain>

/seo ahrefs top-pages <domain>

/seo markdown-audit <path>

Active Commands (Phase 3 — Cross-MCP)

/seo serp <keyword>

/seo content-brief <keyword>

/seo brand-radar <brand>

/seo site-audit-pro <domain>

/seo report <type> <domain>

Active Commands (Phase 4 — Local Analysis)

/seo log-analysis <file>

/seo ai-content-check <url or file>

/seo internal-links <domain>

/seo local <business>

/seo migration-check <old> <new>

Active Commands (Phase 5 — AI Readability)

/seo llms-txt <url|generate|validate>

/seo robots-ai <url>

Orchestration Logic

When the user invokes

/seo audit

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.

Logic ownership: All command logic lives in each sub-skill's SKILL.md (not in agent files). Agents are only used for parallel audit work within

/seo audit

Command Routing

Level 1: Command Group Detection

When the user invokes

/seo <command>

1. Match against the routing table below
2. If exact match with active command → load the sub-skill SKILL.md directly
3. If group match (gsc, ahrefs) → extract sub-command and route to specific sub-skill via Level 2 routing
4. If command sub-skill directory does not exist → return "Not Yet Available" message (see below)
5. If no match → suggest the closest command from the Quick Reference table

Level 2: Sub-command Routing

For grouped commands, extract the sub-command and route to the specific sub-skill:

GSC sub-commands (all require GSC MCP — see

references/mcp-degradation.md

• /seo gsc overview <site>

  → load

  seo-gsc-overview/SKILL.md

• /seo gsc drops <site>

  → load

  seo-gsc-drops/SKILL.md

• /seo gsc opportunities <site>

  → load

  seo-gsc-opportunities/SKILL.md

• /seo gsc brand-vs-nonbrand <site>

  → load

  seo-gsc-brand-vs-nonbrand/SKILL.md

• /seo gsc cannibalization <site>

  → load

  seo-gsc-cannibalization/SKILL.md

• /seo gsc compare <site>

  → load

  seo-gsc-compare/SKILL.md

• /seo gsc content-decay <site>

  → load

  seo-gsc-content-decay/SKILL.md

• /seo gsc index-issues <site>

  → load

  seo-gsc-indexing/SKILL.md

• /seo gsc new-keywords <site>

  → load

  seo-gsc-new-keywords/SKILL.md

Ahrefs sub-commands (all require Ahrefs MCP — see

references/mcp-degradation.md

• /seo ahrefs overview <domain>

  → load

  seo-ahrefs-overview/SKILL.md

• /seo ahrefs backlinks <domain>

  → load

  seo-ahrefs-backlinks/SKILL.md

• /seo ahrefs keywords <domain>

  → load

  seo-ahrefs-keywords/SKILL.md

• /seo ahrefs competitors <domain>

  → load

  seo-ahrefs-competitors/SKILL.md

• /seo ahrefs content-gap <domain>

  → load

  seo-ahrefs-content-gap/SKILL.md

• /seo ahrefs broken-links <domain>

  → load

  seo-ahrefs-broken-links/SKILL.md

• /seo ahrefs new-links <domain>

  → load

  seo-ahrefs-new-links/SKILL.md

• /seo ahrefs anchor-analysis <domain>

  → load

  seo-ahrefs-anchor-analysis/SKILL.md

• /seo ahrefs dr-history <domain>

  → load

  seo-ahrefs-dr-history/SKILL.md

• /seo ahrefs top-pages <domain>

  → load

  seo-ahrefs-top-pages/SKILL.md

Routing Table

Full mapping of all 44 commands to sub-skill directory names:

/seo audit

seo-audit/

/seo page

seo-page/

/seo sitemap

seo-sitemap/

/seo schema

seo-schema/

/seo images

seo-images/

/seo technical

seo-technical/

/seo content

seo-content/

/seo geo

seo-geo/

/seo plan

seo-plan/

/seo programmatic

seo-programmatic/

/seo competitor-pages

seo-competitor-pages/

/seo hreflang

seo-hreflang/

/seo gsc overview

seo-gsc-overview/

/seo gsc drops

seo-gsc-drops/

/seo gsc opportunities

seo-gsc-opportunities/

/seo gsc brand-vs-nonbrand

seo-gsc-brand-vs-nonbrand/

/seo gsc cannibalization

seo-gsc-cannibalization/

/seo gsc compare

seo-gsc-compare/

/seo gsc content-decay

seo-gsc-content-decay/

/seo gsc index-issues

seo-gsc-indexing/

/seo gsc new-keywords

seo-gsc-new-keywords/

/seo ahrefs overview

seo-ahrefs-overview/

/seo ahrefs backlinks

seo-ahrefs-backlinks/

/seo ahrefs keywords

seo-ahrefs-keywords/

/seo ahrefs competitors

seo-ahrefs-competitors/

/seo ahrefs content-gap

seo-ahrefs-content-gap/

/seo ahrefs broken-links

seo-ahrefs-broken-links/

/seo ahrefs new-links

seo-ahrefs-new-links/

/seo ahrefs anchor-analysis

seo-ahrefs-anchor-analysis/

/seo ahrefs dr-history

seo-ahrefs-dr-history/

/seo ahrefs top-pages

seo-ahrefs-top-pages/

/seo markdown-audit

seo-markdown-audit/

/seo serp

seo-serp/

/seo content-brief

seo-content-brief/

/seo brand-radar

seo-brand-radar/

/seo site-audit-pro

seo-site-audit-pro/

/seo report

seo-report/

/seo log-analysis

seo-log-analysis/

/seo ai-content-check

seo-ai-content-check/

/seo internal-links

seo-internal-links/

/seo local

seo-local/

/seo migration-check

seo-migration-check/

/seo llms-txt

seo-llms-txt/

/seo robots-ai

seo-robots-ai/

Unavailable Command Response

If a command's sub-skill directory does not exist:

1. Tell the user: "

   [command]

   is not yet available."
2. Suggest an alternative from the active commands that provides partial value.
3. Do NOT attempt to fabricate the functionality inline.

Example response for unavailable command (Phase 4 and beyond):

/seo [command] is not yet available.

While waiting, you can use:
- `/seo audit <url>` — full site audit using available static analysis
- `/seo site-audit-pro <domain>` — comprehensive multi-MCP audit with live Ahrefs and GSC data

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

• 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

• references/mcp-degradation.md

  — MCP availability checks, error templates, fallback mapping

• references/ahrefs-api-reference.md

  — Ahrefs MCP tool mapping, response fields, monetary conversion

• references/gsc-api-reference.md

  — GSC MCP tool mapping, property formats, response fields

• references/llms-txt-spec.md

  — llms.txt specification, format rules, tooling, examples, 2000+ adopter list

• references/ai-crawlers-guide.md

  — AI crawler registry, robots.txt tokens, blocking stats, strategy templates

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 44 specialized sub-skills (44 active):

Active (Phase 1 — Static Analysis):

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

Active (Phase 2 — GSC MCP, requires GSC MCP registration): 13. seo-gsc-overview — GSC performance dashboard 14. seo-gsc-drops — Ranking drop detection 15. seo-gsc-opportunities — High-impression, low-CTR opportunity finder 16. seo-gsc-brand-vs-nonbrand — Brand vs non-brand traffic split analysis 17. seo-gsc-cannibalization — Keyword cannibalization detection 18. seo-gsc-compare — Period-over-period comparison 19. seo-gsc-content-decay — Pages losing rankings over 90 days 20. seo-gsc-indexing — Pages not indexed with reasons 21. seo-gsc-new-keywords — Keywords started ranking for recently

Active (Phase 2 — Ahrefs MCP): 22. seo-ahrefs-overview — Domain authority and top metrics 23. seo-ahrefs-backlinks — Backlink profile analysis 24. seo-ahrefs-keywords — Organic keyword rankings 25. seo-ahrefs-competitors — Organic competitor identification 26. seo-ahrefs-content-gap — Content gap analysis 27. seo-ahrefs-broken-links — Broken backlink recovery 28. seo-ahrefs-new-links — New referring domain monitoring 29. seo-ahrefs-anchor-analysis — Anchor text distribution 30. seo-ahrefs-dr-history — Domain Rating history 31. seo-ahrefs-top-pages — Top pages by organic traffic

Active (Phase 2 — Local/No MCP): 32. seo-markdown-audit — Markdown file SEO audit (no MCP needed)

Active (Phase 3 — Cross-MCP): 33. seo-serp — Live SERP analysis 34. seo-content-brief — AI content brief from SERP data 35. seo-brand-radar — Brand monitoring via Ahrefs Brand Radar 36. seo-site-audit-pro — Flagship multi-MCP audit (sequential wave) 37. seo-report — Automated report generation

Active (Phase 4 — Local Analysis): 38. seo-log-analysis — Server log crawl budget analysis 39. seo-ai-content-check — AI content detection 40. seo-internal-links — Internal link structure audit 41. seo-local — Local SEO audit 42. seo-migration-check — Site migration validator

Active (Phase 5 — AI Readability): 43. seo-llms-txt — llms.txt generation, validation, and audit 44. seo-robots-ai — AI crawler robots.txt audit

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