SEO — Universal SEO Analysis Skill
Comprehensive SEO analysis across all industries (SaaS, local services,
e-commerce, publishers, agencies). Orchestrates 52 specialized sub-skills
(52 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 |
/seo obsidian-kb --sitemap <url> |
Build an Obsidian knowledge base from a sitemap |
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 |
Active Commands (Phase 6 — Performance & Quality)
| Command |
What it does |
Status |
/seo lighthouse-audit <url> |
Lighthouse audit (CLI or PSI API fallback) with per-audit fixes and Chrome docs |
active |
/seo core-web-vitals <url> |
CWV deep-dive — CrUX field data + lab fallback, LCP subparts, INP/CLS playbooks |
active |
/seo page-experience <url> |
Page-experience self-assessment — HTTPS, interstitials, mobile usability, CWV, ads |
active |
/seo rich-results <url> |
Per-type rich result eligibility check with required/recommended property gap report |
active |
/seo ai-optimization <url> |
Audit against Google's AI Optimization guide — AI Overviews / AI Mode readiness |
active |
/seo eeat-audit <url> |
Standalone E-E-A-T scoring rubric (0-5 per dimension) with trust signals |
active |
/seo helpful-content <url> |
Pre-publish content-quality gate — people-first questions + spam-policy red flags |
active |
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
- 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.
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>:
- Match against the routing table below
- If exact match with active command → load the sub-skill SKILL.md directly
- If group match (gsc, ahrefs) → extract sub-command and route to specific sub-skill via Level 2 routing
- If command sub-skill directory does not exist → return "Not Yet Available" message (see below)
- 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
Disambiguation Rules
Some trigger phrases match more than one sub-skill. Route by intent:
- "AI Overviews" / "AI search" →
seo-ai-optimization when the user asks about Google's AI features (AI Overviews, AI Mode) or Google's official guidance; → seo-geo when the user targets multiple AI engines (ChatGPT, Perplexity, Claude) or says "GEO" broadly. Default for bare "optimize for AI Overviews": seo-ai-optimization.
- "Core Web Vitals" / "site speed" →
seo-core-web-vitals for a metric-focused diagnosis (field data, LCP/INP/CLS playbooks); → seo-technical only when CWV is part of a broader technical audit request. Default for bare "Core Web Vitals": seo-core-web-vitals.
- "E-E-A-T" →
seo-eeat-audit for a standalone E-E-A-T score of a URL or draft; → seo-content when the user wants a full content-quality audit that includes E-E-A-T.
- "lighthouse" / "pagespeed" →
seo-lighthouse-audit (never seo-technical).
Routing Table
Full mapping of all 52 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-hreflang/ |
active |
/seo gsc overview |
seo-gsc-overview/ |
active |
/seo gsc drops |
seo-gsc-drops/ |
active |
/seo gsc opportunities |
seo-gsc-opportunities/ |
active |
/seo gsc brand-vs-nonbrand |
seo-gsc-brand-vs-nonbrand/ |
active |
/seo gsc cannibalization |
seo-gsc-cannibalization/ |
active |
/seo gsc compare |
seo-gsc-compare/ |
active |
/seo gsc content-decay |
seo-gsc-content-decay/ |
active |
/seo gsc index-issues |
seo-gsc-indexing/ |
active |
/seo gsc new-keywords |
seo-gsc-new-keywords/ |
active |
/seo ahrefs overview |
seo-ahrefs-overview/ |
active |
/seo ahrefs backlinks |
seo-ahrefs-backlinks/ |
active |
/seo ahrefs keywords |
seo-ahrefs-keywords/ |
active |
/seo ahrefs competitors |
seo-ahrefs-competitors/ |
active |
/seo ahrefs content-gap |
seo-ahrefs-content-gap/ |
active |
/seo ahrefs broken-links |
seo-ahrefs-broken-links/ |
active |
/seo ahrefs new-links |
seo-ahrefs-new-links/ |
active |
/seo ahrefs anchor-analysis |
seo-ahrefs-anchor-analysis/ |
active |
/seo ahrefs dr-history |
seo-ahrefs-dr-history/ |
active |
/seo ahrefs top-pages |
seo-ahrefs-top-pages/ |
active |
/seo markdown-audit |
seo-markdown-audit/ |
active |
/seo serp |
seo-serp/ |
active |
/seo content-brief |
seo-content-brief/ |
active |
/seo brand-radar |
seo-brand-radar/ |
active |
/seo site-audit-pro |
seo-site-audit-pro/ |
active |
/seo report |
seo-report/ |
active |
/seo log-analysis |
seo-log-analysis/ |
active |
/seo ai-content-check |
seo-ai-content-check/ |
active |
/seo internal-links |
seo-internal-links/ |
active |
/seo local |
seo-local/ |
active |
/seo migration-check |
seo-migration-check/ |
active |
/seo obsidian-kb |
seo-obsidian-kb/ |
active |
/seo llms-txt |
seo-llms-txt/ |
active |
/seo robots-ai |
seo-robots-ai/ |
active |
/seo lighthouse-audit |
seo-lighthouse-audit/ |
active |
/seo core-web-vitals |
seo-core-web-vitals/ |
active |
/seo page-experience |
seo-page-experience/ |
active |
/seo rich-results |
seo-rich-results/ |
active |
/seo ai-optimization |
seo-ai-optimization/ |
active |
/seo eeat-audit |
seo-eeat-audit/ |
active |
/seo helpful-content |
seo-helpful-content/ |
active |
Unavailable Command Response
If a command's sub-skill directory does not exist:
- Tell the user: "
[command] is not yet available."
- Suggest an alternative from the active commands that provides partial value.
- 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 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 detailsreferences/schema-types.md — All supported schema types with deprecation statusreferences/eeat-framework.md — E-E-A-T evaluation criteria (Sept 2025 QRG update)references/quality-gates.md — Content length minimums, uniqueness thresholdsreferences/mcp-degradation.md — MCP availability checks, error templates, fallback mappingreferences/ahrefs-api-reference.md — Ahrefs MCP tool mapping, response fields, monetary conversionreferences/gsc-api-reference.md — GSC MCP tool mapping, property formats, response fieldsreferences/llms-txt-spec.md — llms.txt specification, format rules, tooling, examples, 2000+ adopter listreferences/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:
| 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 52 specialized sub-skills (52 active):
Active (Phase 1 — Static Analysis):
- seo-audit — Full website audit with parallel delegation
- seo-page — Deep single-page analysis
- seo-technical — Technical SEO (8 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
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
43. seo-obsidian-kb — Obsidian knowledge base builder from sitemap
Active (Phase 5 — AI Readability):
44. seo-llms-txt — llms.txt generation, validation, and audit
45. seo-robots-ai — AI crawler robots.txt audit
Active (Phase 6 — Performance & Quality):
46. seo-lighthouse-audit — Lighthouse audits with per-audit fixes and Chrome docs
47. seo-core-web-vitals — CWV deep-dive (CrUX field data, LCP subparts, INP/CLS playbooks)
48. seo-page-experience — Google page-experience self-assessment
49. seo-rich-results — Per-type rich result eligibility checker
50. seo-ai-optimization — Google AI Optimization guide audit (AI Overviews / AI Mode readiness)
51. seo-eeat-audit — Standalone E-E-A-T scoring rubric with trust signals
52. seo-helpful-content — Pre-publish people-first content-quality gate
Subagents
For parallel analysis during audits:
seo-technical — Crawlability, indexability, security, CWVseo-content — E-E-A-T, readability, thin contentseo-schema — Detection, validation, generationseo-sitemap — Structure, coverage, quality gatesseo-performance — Core Web Vitals measurementseo-visual — Screenshots, mobile testing, above-fold
1---2name: seo3description: Comprehensive SEO analysis for any website or business type. Orchestrates 52 sub-skills (52 active): full site audits, technical SEO (CWV/INP), schema, E-E-A-T content quality, images, sitemaps, GEO for AI Overviews, llms.txt generation, AI crawler audit, plus live GSC and Ahrefs MCP data. GSC: overview, drops, opportunities, brand-vs-nonbrand, cannibalization, compare, content-decay, index-issues, new-keywords. Ahrefs: overview, backlinks, keywords, competitors, content-gap, broken-links, new-links, anchor-analysis, dr-history, top-pages. Cross-MCP: serp, content-brief, brand-radar, site-audit-pro, report. Local: log-analysis, ai-content-check, internal-links, local, migration-check, obsidian-kb. AI Readability: llms-txt, robots-ai. Performance: lighthouse-audit, core-web-vitals, page-experience. Quality & AI Search: rich-results, ai-optimization, eeat-audit, helpful-content. Triggers on: "SEO", "audit", "schema", "Core Web Vitals", "sitemap", "E-E-A-T", "AI Overviews", "GEO", "technical SEO", "content quali4---56# SEO — Universal SEO Analysis Skill78Comprehensive SEO analysis across all industries (SaaS, local services,9e-commerce, publishers, agencies). Orchestrates 52 specialized sub-skills10(52 active) and 6 subagents.1112## Quick Reference1314### Active Commands (Phase 1 — Enhanced)1516| Command | What it does | Status |17|---------|-------------|--------|18| `/seo audit <url>` | Full website audit with parallel subagent delegation | active |19| `/seo page <url>` | Deep single-page analysis | active |20| `/seo sitemap <url or generate>` | Analyze or generate XML sitemaps | active |21| `/seo schema <url>` | Detect, validate, and generate Schema.org markup | active |22| `/seo images <url>` | Image optimization analysis | active |23| `/seo technical <url>` | Technical SEO audit (8 categories) | active |24| `/seo content <url>` | E-E-A-T and content quality analysis | active |25| `/seo geo <url>` | AI Overviews / Generative Engine Optimization | active |26| `/seo plan <business-type>` | Strategic SEO planning | active |27| `/seo programmatic [url\|plan]` | Programmatic SEO analysis and planning | active |28| `/seo competitor-pages [url\|generate]` | Competitor comparison page generation | active |29| `/seo hreflang [url]` | Hreflang/i18n SEO audit and generation | active |3031### Active Commands (Phase 2 — Live MCP Data)3233| Command | What it does | Status |34|---------|-------------|--------|35| `/seo gsc overview <site>` | GSC performance overview (clicks, impressions, CTR, position) | active |36| `/seo gsc drops <site>` | Detect keyword/page ranking drops | active |37| `/seo gsc opportunities <site>` | Find high-impression, low-CTR opportunities | active |38| `/seo gsc brand-vs-nonbrand <site>` | Brand vs non-brand traffic split analysis | active |39| `/seo gsc cannibalization <site>` | Detect keyword cannibalization | active |40| `/seo gsc compare <site>` | Period-over-period comparison (MoM, YoY) | active |41| `/seo gsc content-decay <site>` | Pages losing rankings over 90 days | active |42| `/seo gsc index-issues <site>` | Pages not indexed with reasons | active |43| `/seo gsc new-keywords <site>` | Keywords started ranking for recently | active |44| `/seo ahrefs overview <domain>` | Domain authority, traffic, and top metrics | active |45| `/seo ahrefs backlinks <domain>` | Backlink profile analysis | active |46| `/seo ahrefs keywords <domain>` | Organic keyword rankings | active |47| `/seo ahrefs competitors <domain>` | Identify organic competitors | active |48| `/seo ahrefs content-gap <domain>` | Keywords competitors rank for, you don't | active |49| `/seo ahrefs broken-links <domain>` | Find broken backlinks to reclaim | active |50| `/seo ahrefs new-links <domain>` | New referring domains (last 30 days) | active |51| `/seo ahrefs anchor-analysis <domain>` | Anchor text distribution analysis | active |52| `/seo ahrefs dr-history <domain>` | Domain Rating history trend | active |53| `/seo ahrefs top-pages <domain>` | Top pages by organic traffic | active |54| `/seo markdown-audit <path>` | Markdown SEO audit (no MCP needed) | active |5556### Active Commands (Phase 3 — Cross-MCP)5758| Command | What it does | Status |59|---------|-------------|--------|60| `/seo serp <keyword>` | Live SERP analysis via Ahrefs + WebMCP | active |61| `/seo content-brief <keyword>` | AI content brief from SERP data | active |62| `/seo brand-radar <brand>` | AI search brand monitoring via Ahrefs Brand Radar | active |63| `/seo site-audit-pro <domain>` | Flagship multi-MCP audit (sequential wave architecture) | active |64| `/seo report <type> <domain>` | Automated report generation from available MCP data | active |6566### Active Commands (Phase 4 — Local Analysis)6768| Command | What it does | Status |69|---------|-------------|--------|70| `/seo log-analysis <file>` | Server log crawl budget analysis | active |71| `/seo ai-content-check <url or file>` | AI content detection and authenticity scoring | active |72| `/seo internal-links <domain>` | Internal link structure analysis and orphan detection | active |73| `/seo local <business>` | Local SEO audit (NAP, schema, GBP, citations) | active |74| `/seo migration-check <old> <new>` | Site migration redirect and SEO validator | active |75| `/seo obsidian-kb --sitemap <url>` | Build an Obsidian knowledge base from a sitemap | active |7677### Active Commands (Phase 5 — AI Readability)7879| Command | What it does | Status |80|---------|-------------|--------|81| `/seo llms-txt <url\|generate\|validate>` | Generate, validate, or audit llms.txt files | active |82| `/seo robots-ai <url>` | Audit robots.txt for AI crawler access policies | active |8384### Active Commands (Phase 6 — Performance & Quality)8586| Command | What it does | Status |87|---------|-------------|--------|88| `/seo lighthouse-audit <url>` | Lighthouse audit (CLI or PSI API fallback) with per-audit fixes and Chrome docs | active |89| `/seo core-web-vitals <url>` | CWV deep-dive — CrUX field data + lab fallback, LCP subparts, INP/CLS playbooks | active |90| `/seo page-experience <url>` | Page-experience self-assessment — HTTPS, interstitials, mobile usability, CWV, ads | active |91| `/seo rich-results <url>` | Per-type rich result eligibility check with required/recommended property gap report | active |92| `/seo ai-optimization <url>` | Audit against Google's AI Optimization guide — AI Overviews / AI Mode readiness | active |93| `/seo eeat-audit <url>` | Standalone E-E-A-T scoring rubric (0-5 per dimension) with trust signals | active |94| `/seo helpful-content <url>` | Pre-publish content-quality gate — people-first questions + spam-policy red flags | active |9596## Orchestration Logic9798When the user invokes `/seo audit`, delegate to subagents in parallel:991. Detect business type (SaaS, local, ecommerce, publisher, agency, other)1002. Spawn subagents: seo-technical, seo-content, seo-schema, seo-sitemap, seo-performance, seo-visual1013. Collect results and generate unified report with SEO Health Score (0-100)1024. Create prioritized action plan (Critical → High → Medium → Low)103104For individual commands, load the relevant sub-skill directly.105106**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`.107108## Command Routing109110### Level 1: Command Group Detection111112When the user invokes `/seo <command>`:1131. Match against the routing table below1142. If exact match with active command → load the sub-skill SKILL.md directly1153. If group match (gsc, ahrefs) → extract sub-command and route to specific sub-skill via Level 2 routing1164. If command sub-skill directory does not exist → return "Not Yet Available" message (see below)1175. If no match → suggest the closest command from the Quick Reference table118119### Level 2: Sub-command Routing120121For grouped commands, extract the sub-command and route to the specific sub-skill:122123**GSC sub-commands** (all require GSC MCP — see `references/mcp-degradation.md`):124- `/seo gsc overview <site>` → load `seo-gsc-overview/SKILL.md`125- `/seo gsc drops <site>` → load `seo-gsc-drops/SKILL.md`126- `/seo gsc opportunities <site>` → load `seo-gsc-opportunities/SKILL.md`127- `/seo gsc brand-vs-nonbrand <site>` → load `seo-gsc-brand-vs-nonbrand/SKILL.md`128- `/seo gsc cannibalization <site>` → load `seo-gsc-cannibalization/SKILL.md`129- `/seo gsc compare <site>` → load `seo-gsc-compare/SKILL.md`130- `/seo gsc content-decay <site>` → load `seo-gsc-content-decay/SKILL.md`131- `/seo gsc index-issues <site>` → load `seo-gsc-indexing/SKILL.md`132- `/seo gsc new-keywords <site>` → load `seo-gsc-new-keywords/SKILL.md`133134**Ahrefs sub-commands** (all require Ahrefs MCP — see `references/mcp-degradation.md`):135- `/seo ahrefs overview <domain>` → load `seo-ahrefs-overview/SKILL.md`136- `/seo ahrefs backlinks <domain>` → load `seo-ahrefs-backlinks/SKILL.md`137- `/seo ahrefs keywords <domain>` → load `seo-ahrefs-keywords/SKILL.md`138- `/seo ahrefs competitors <domain>` → load `seo-ahrefs-competitors/SKILL.md`139- `/seo ahrefs content-gap <domain>` → load `seo-ahrefs-content-gap/SKILL.md`140- `/seo ahrefs broken-links <domain>` → load `seo-ahrefs-broken-links/SKILL.md`141- `/seo ahrefs new-links <domain>` → load `seo-ahrefs-new-links/SKILL.md`142- `/seo ahrefs anchor-analysis <domain>` → load `seo-ahrefs-anchor-analysis/SKILL.md`143- `/seo ahrefs dr-history <domain>` → load `seo-ahrefs-dr-history/SKILL.md`144- `/seo ahrefs top-pages <domain>` → load `seo-ahrefs-top-pages/SKILL.md`145146### Disambiguation Rules147148Some trigger phrases match more than one sub-skill. Route by intent:149150- **"AI Overviews" / "AI search"** → `seo-ai-optimization` when the user asks about Google's AI features (AI Overviews, AI Mode) or Google's official guidance; → `seo-geo` when the user targets multiple AI engines (ChatGPT, Perplexity, Claude) or says "GEO" broadly. Default for bare "optimize for AI Overviews": `seo-ai-optimization`.151- **"Core Web Vitals" / "site speed"** → `seo-core-web-vitals` for a metric-focused diagnosis (field data, LCP/INP/CLS playbooks); → `seo-technical` only when CWV is part of a broader technical audit request. Default for bare "Core Web Vitals": `seo-core-web-vitals`.152- **"E-E-A-T"** → `seo-eeat-audit` for a standalone E-E-A-T score of a URL or draft; → `seo-content` when the user wants a full content-quality audit that includes E-E-A-T.153- **"lighthouse" / "pagespeed"** → `seo-lighthouse-audit` (never `seo-technical`).154155### Routing Table156157Full mapping of all 52 commands to sub-skill directory names:158159| Command | Sub-skill Directory | Status |160|---------|--------------------|----|161| `/seo audit` | `seo-audit/` | active |162| `/seo page` | `seo-page/` | active |163| `/seo sitemap` | `seo-sitemap/` | active |164| `/seo schema` | `seo-schema/` | active |165| `/seo images` | `seo-images/` | active |166| `/seo technical` | `seo-technical/` | active |167| `/seo content` | `seo-content/` | active |168| `/seo geo` | `seo-geo/` | active |169| `/seo plan` | `seo-plan/` | active |170| `/seo programmatic` | `seo-programmatic/` | active |171| `/seo competitor-pages` | `seo-competitor-pages/` | active |172| `/seo hreflang` | `seo-hreflang/` | active |173| `/seo gsc overview` | `seo-gsc-overview/` | active |174| `/seo gsc drops` | `seo-gsc-drops/` | active |175| `/seo gsc opportunities` | `seo-gsc-opportunities/` | active |176| `/seo gsc brand-vs-nonbrand` | `seo-gsc-brand-vs-nonbrand/` | active |177| `/seo gsc cannibalization` | `seo-gsc-cannibalization/` | active |178| `/seo gsc compare` | `seo-gsc-compare/` | active |179| `/seo gsc content-decay` | `seo-gsc-content-decay/` | active |180| `/seo gsc index-issues` | `seo-gsc-indexing/` | active |181| `/seo gsc new-keywords` | `seo-gsc-new-keywords/` | active |182| `/seo ahrefs overview` | `seo-ahrefs-overview/` | active |183| `/seo ahrefs backlinks` | `seo-ahrefs-backlinks/` | active |184| `/seo ahrefs keywords` | `seo-ahrefs-keywords/` | active |185| `/seo ahrefs competitors` | `seo-ahrefs-competitors/` | active |186| `/seo ahrefs content-gap` | `seo-ahrefs-content-gap/` | active |187| `/seo ahrefs broken-links` | `seo-ahrefs-broken-links/` | active |188| `/seo ahrefs new-links` | `seo-ahrefs-new-links/` | active |189| `/seo ahrefs anchor-analysis` | `seo-ahrefs-anchor-analysis/` | active |190| `/seo ahrefs dr-history` | `seo-ahrefs-dr-history/` | active |191| `/seo ahrefs top-pages` | `seo-ahrefs-top-pages/` | active |192| `/seo markdown-audit` | `seo-markdown-audit/` | active |193| `/seo serp` | `seo-serp/` | active |194| `/seo content-brief` | `seo-content-brief/` | active |195| `/seo brand-radar` | `seo-brand-radar/` | active |196| `/seo site-audit-pro` | `seo-site-audit-pro/` | active |197| `/seo report` | `seo-report/` | active |198| `/seo log-analysis` | `seo-log-analysis/` | active |199| `/seo ai-content-check` | `seo-ai-content-check/` | active |200| `/seo internal-links` | `seo-internal-links/` | active |201| `/seo local` | `seo-local/` | active |202| `/seo migration-check` | `seo-migration-check/` | active |203| `/seo obsidian-kb` | `seo-obsidian-kb/` | active |204| `/seo llms-txt` | `seo-llms-txt/` | active |205| `/seo robots-ai` | `seo-robots-ai/` | active |206| `/seo lighthouse-audit` | `seo-lighthouse-audit/` | active |207| `/seo core-web-vitals` | `seo-core-web-vitals/` | active |208| `/seo page-experience` | `seo-page-experience/` | active |209| `/seo rich-results` | `seo-rich-results/` | active |210| `/seo ai-optimization` | `seo-ai-optimization/` | active |211| `/seo eeat-audit` | `seo-eeat-audit/` | active |212| `/seo helpful-content` | `seo-helpful-content/` | active |213214### Unavailable Command Response215216If a command's sub-skill directory does not exist:2171. Tell the user: "`[command]` is not yet available."2182. Suggest an alternative from the active commands that provides partial value.2193. Do NOT attempt to fabricate the functionality inline.220221Example response for unavailable command (Phase 4 and beyond):222```223/seo [command] is not yet available.224225While waiting, you can use:226- `/seo audit <url>` — full site audit using available static analysis227- `/seo site-audit-pro <domain>` — comprehensive multi-MCP audit with live Ahrefs and GSC data228```229230## Industry Detection231232Detect business type from homepage signals:233- **SaaS**: pricing page, /features, /integrations, /docs, "free trial", "sign up"234- **Local Service**: phone number, address, service area, "serving [city]", Google Maps embed235- **E-commerce**: /products, /collections, /cart, "add to cart", product schema236- **Publisher**: /blog, /articles, /topics, article schema, author pages, publication dates237- **Agency**: /case-studies, /portfolio, /industries, "our work", client logos238239## Quality Gates240241Read `references/quality-gates.md` for thin content thresholds per page type.242Hard rules:243- WARNING at 30+ location pages (enforce 60%+ unique content)244- HARD STOP at 50+ location pages (require user justification)245- Never recommend HowTo schema (deprecated Sept 2023)246- FAQ schema only for government and healthcare sites247- All Core Web Vitals references use INP, never FID248249## Reference Files250251Load these on-demand as needed — do NOT load all at startup:252- `references/cwv-thresholds.md` — Current Core Web Vitals thresholds and measurement details253- `references/schema-types.md` — All supported schema types with deprecation status254- `references/eeat-framework.md` — E-E-A-T evaluation criteria (Sept 2025 QRG update)255- `references/quality-gates.md` — Content length minimums, uniqueness thresholds256- `references/mcp-degradation.md` — MCP availability checks, error templates, fallback mapping257- `references/ahrefs-api-reference.md` — Ahrefs MCP tool mapping, response fields, monetary conversion258- `references/gsc-api-reference.md` — GSC MCP tool mapping, property formats, response fields259- `references/llms-txt-spec.md` — llms.txt specification, format rules, tooling, examples, 2000+ adopter list260- `references/ai-crawlers-guide.md` — AI crawler registry, robots.txt tokens, blocking stats, strategy templates261262## Scoring Methodology263264### SEO Health Score (0-100)265Weighted aggregate of all categories:266267| Category | Weight |268|----------|--------|269| Technical SEO | 25% |270| Content Quality | 25% |271| On-Page SEO | 20% |272| Schema / Structured Data | 10% |273| Performance (CWV) | 10% |274| Images | 5% |275| AI Search Readiness | 5% |276277### Priority Levels278- **Critical**: Blocks indexing or causes penalties (immediate fix required)279- **High**: Significantly impacts rankings (fix within 1 week)280- **Medium**: Optimization opportunity (fix within 1 month)281- **Low**: Nice to have (backlog)282283## Sub-Skills284285This skill orchestrates 52 specialized sub-skills (52 active):286287**Active (Phase 1 — Static Analysis):**2881. **seo-audit** — Full website audit with parallel delegation2892. **seo-page** — Deep single-page analysis2903. **seo-technical** — Technical SEO (8 categories)2914. **seo-content** — E-E-A-T and content quality2925. **seo-schema** — Schema markup detection and generation2936. **seo-images** — Image optimization2947. **seo-sitemap** — Sitemap analysis and generation2958. **seo-geo** — AI Overviews / GEO optimization2969. **seo-plan** — Strategic planning with templates29710. **seo-programmatic** — Programmatic SEO analysis and planning29811. **seo-competitor-pages** — Competitor comparison page generation29912. **seo-hreflang** — Hreflang/i18n SEO audit and generation300301**Active (Phase 2 — GSC MCP, requires GSC MCP registration):**30213. **seo-gsc-overview** — GSC performance dashboard30314. **seo-gsc-drops** — Ranking drop detection30415. **seo-gsc-opportunities** — High-impression, low-CTR opportunity finder30516. **seo-gsc-brand-vs-nonbrand** — Brand vs non-brand traffic split analysis30617. **seo-gsc-cannibalization** — Keyword cannibalization detection30718. **seo-gsc-compare** — Period-over-period comparison30819. **seo-gsc-content-decay** — Pages losing rankings over 90 days30920. **seo-gsc-indexing** — Pages not indexed with reasons31021. **seo-gsc-new-keywords** — Keywords started ranking for recently311312**Active (Phase 2 — Ahrefs MCP):**31322. **seo-ahrefs-overview** — Domain authority and top metrics31423. **seo-ahrefs-backlinks** — Backlink profile analysis31524. **seo-ahrefs-keywords** — Organic keyword rankings31625. **seo-ahrefs-competitors** — Organic competitor identification31726. **seo-ahrefs-content-gap** — Content gap analysis31827. **seo-ahrefs-broken-links** — Broken backlink recovery31928. **seo-ahrefs-new-links** — New referring domain monitoring32029. **seo-ahrefs-anchor-analysis** — Anchor text distribution32130. **seo-ahrefs-dr-history** — Domain Rating history32231. **seo-ahrefs-top-pages** — Top pages by organic traffic323324**Active (Phase 2 — Local/No MCP):**32532. **seo-markdown-audit** — Markdown file SEO audit (no MCP needed)326327**Active (Phase 3 — Cross-MCP):**32833. **seo-serp** — Live SERP analysis32934. **seo-content-brief** — AI content brief from SERP data33035. **seo-brand-radar** — Brand monitoring via Ahrefs Brand Radar33136. **seo-site-audit-pro** — Flagship multi-MCP audit (sequential wave)33237. **seo-report** — Automated report generation333334**Active (Phase 4 — Local Analysis):**33538. **seo-log-analysis** — Server log crawl budget analysis33639. **seo-ai-content-check** — AI content detection33740. **seo-internal-links** — Internal link structure audit33841. **seo-local** — Local SEO audit33942. **seo-migration-check** — Site migration validator34043. **seo-obsidian-kb** — Obsidian knowledge base builder from sitemap341342**Active (Phase 5 — AI Readability):**34344. **seo-llms-txt** — llms.txt generation, validation, and audit34445. **seo-robots-ai** — AI crawler robots.txt audit345346**Active (Phase 6 — Performance & Quality):**34746. **seo-lighthouse-audit** — Lighthouse audits with per-audit fixes and Chrome docs34847. **seo-core-web-vitals** — CWV deep-dive (CrUX field data, LCP subparts, INP/CLS playbooks)34948. **seo-page-experience** — Google page-experience self-assessment35049. **seo-rich-results** — Per-type rich result eligibility checker35150. **seo-ai-optimization** — Google AI Optimization guide audit (AI Overviews / AI Mode readiness)35251. **seo-eeat-audit** — Standalone E-E-A-T scoring rubric with trust signals35352. **seo-helpful-content** — Pre-publish people-first content-quality gate354355## Subagents356357For parallel analysis during audits:358- `seo-technical` — Crawlability, indexability, security, CWV359- `seo-content` — E-E-A-T, readability, thin content360- `seo-schema` — Detection, validation, generation361- `seo-sitemap` — Structure, coverage, quality gates362- `seo-performance` — Core Web Vitals measurement363- `seo-visual` — Screenshots, mobile testing, above-fold
lionkiii