seo

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)

| Command | What it does | Status | |---------|-------------|--------| | /seo audit <url> | Full website audit with parallel subagent delegation | active | | /seo page <url> | Deep single-page analysis | active | | /seo sitemap <url or generate> | Analyze or generate XML sitemaps | active | | /seo schema <url> | Detect, validate, and generate Schema.org markup | active | | /seo images <url> | Image optimization analysis | active | | /seo technical <url> | Technical SEO audit (8 categories) | active | | /seo content <url> | E-E-A-T and content quality analysis | active | | /seo geo <url> | AI Overviews / Generative Engine Optimization | active | | /seo plan <business-type> | Strategic SEO planning | active | | /seo programmatic [url\|plan] | Programmatic SEO analysis and planning | active | | /seo competitor-pages [url\|generate] | Competitor comparison page generation | active | | /seo hreflang [url] | Hreflang/i18n SEO audit and generation | active |

Active Commands (Phase 2 — Live MCP Data)

| Command | What it does | Status | |---------|-------------|--------| | /seo gsc overview <site> | GSC performance overview (clicks, impressions, CTR, position) | active | | /seo gsc drops <site> | Detect keyword/page ranking drops | active | | /seo gsc opportunities <site> | Find high-impression, low-CTR opportunities | active | | /seo gsc brand-vs-nonbrand <site> | Brand vs non-brand traffic split analysis | active | | /seo gsc cannibalization <site> | Detect keyword cannibalization | active | | /seo gsc compare <site> | Period-over-period comparison (MoM, YoY) | active | | /seo gsc content-decay <site> | Pages losing rankings over 90 days | active | | /seo gsc index-issues <site> | Pages not indexed with reasons | active | | /seo gsc new-keywords <site> | Keywords started ranking for recently | active | | /seo ahrefs overview <domain> | Domain authority, traffic, and top metrics | active | | /seo ahrefs backlinks <domain> | Backlink profile analysis | active | | /seo ahrefs keywords <domain> | Organic keyword rankings | active | | /seo ahrefs competitors <domain> | Identify organic competitors | active | | /seo ahrefs content-gap <domain> | Keywords competitors rank for, you don't | active | | /seo ahrefs broken-links <domain> | Find broken backlinks to reclaim | active | | /seo ahrefs new-links <domain> | New referring domains (last 30 days) | active | | /seo ahrefs anchor-analysis <domain> | Anchor text distribution analysis | active | | /seo ahrefs dr-history <domain> | Domain Rating history trend | active | | /seo ahrefs top-pages <domain> | Top pages by organic traffic | active | | /seo markdown-audit <path> | Markdown SEO audit (no MCP needed) | active |

Active Commands (Phase 3 — Cross-MCP)

| Command | What it does | Status | |---------|-------------|--------| | /seo serp <keyword> | Live SERP analysis via Ahrefs + WebMCP | active | | /seo content-brief <keyword> | AI content brief from SERP data | active | | /seo brand-radar <brand> | AI search brand monitoring via Ahrefs Brand Radar | active | | /seo site-audit-pro <domain> | Flagship multi-MCP audit (sequential wave architecture) | active | | /seo report <type> <domain> | Automated report generation from available MCP data | active |

Active Commands (Phase 4 — Local Analysis)

| Command | What it does | Status | |---------|-------------|--------| | /seo log-analysis <file> | Server log crawl budget analysis | active | | /seo ai-content-check <url or file> | AI content detection and authenticity scoring | active | | /seo internal-links <domain> | Internal link structure analysis and orphan detection | active | | /seo local <business> | Local SEO audit (NAP, schema, GBP, citations) | active | | /seo migration-check <old> <new> | Site migration redirect and SEO validator | active |

Active Commands (Phase 5 — AI Readability)

| Command | What it does | Status | |---------|-------------|--------| | /seo llms-txt <url\|generate\|validate> | Generate, validate, or audit llms.txt files | active | | /seo robots-ai <url> | Audit robots.txt for AI crawler access policies | active |

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.

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:

| Command | Sub-skill Directory | Status | |---------|--------------------|----| | /seo audit | seo-audit/ | active | | /seo page | seo-page/ | active | | /seo sitemap | seo-sitemap/ | active | | /seo schema | seo-schema/ | active | | /seo images | seo-images/ | active | | /seo technical | seo-technical/ | active | | /seo content | seo-content/ | active | | /seo geo | seo-geo/ | active | | /seo plan | seo-plan/ | active | | /seo programmatic | seo-programmatic/ | active | | /seo competitor-pages | seo-competitor-pages/ | active | | /seo hreflang | `seo-h