SEO — Master Orchestrator (24 Sub-Skills)

[PROTOCOL]: Update this header on changes

Comprehensive SEO analysis across all industries (SaaS, local services, e-commerce, publishers, agencies). Orchestrates 24 specialized sub-skills organized in 9 categories, plus 6 parallel subagents for audits.

---

Quick Reference

1. Audit

Command	What it does
/seo audit <url>	Full-site audit — first run squirrelscan audit <url> --format llm (if installed), then spawn subagents for deep analysis
/seo page <url>	Deep single-page analysis: title, meta, headings, links, images, Schema, E-E-A-T
squirrelscan audit <url>	Full-site 230+ rules audit via CLI (npm i -g squirrelscan)

2. Technical SEO

Command	What it does
/seo technical <url>	8-category audit: crawl, index, security, URLs, mobile, CWV, structured data, JS
/seo sitemap <url>	Validate XML sitemaps, detect issues, generate new ones
/seo hreflang <url>	Multi-language SEO: self-refs, return tags, x-default, ISO codes
/seo schema <url>	Detect, validate, generate JSON-LD structured data
/seo geo-technical <url>	AI crawler management: GPTBot, ClaudeBot, llms.txt, SSR check

3. Links

Command	What it does
/seo internal-links <url>	Orphan pages, click depth, anchor text, link equity
/seo backlinks profile <domain>	Backlink profile analysis (DataForSEO)
/seo backlinks gap <domain> <competitor>	Find link gap opportunities (DataForSEO)
/seo redirects <url>	Chains, loops, 301/302 mix, protocol issues, trailing slashes

4. Content

Command	What it does
/seo content-audit <url>	E-E-A-T scoring + AI citability analysis
/seo images <url>	Alt text, file sizes, formats (WebP/AVIF), lazy loading, CLS
/seo content-decay <url>	Detect declining content, recommend refresh priorities
/seo cannibalization <domain>	Find keyword conflicts between pages
/seo content-brief <keyword>	Analyze SERP top 10, generate content briefs
/seo content-writer	SEO + AI optimized writing guidelines

5. Planning

Command	What it does
/seo plan <business-type>	Competitor analysis, keyword strategy, content calendar, 4-phase roadmap
/seo architecture <url>	URL structure, navigation design, internal linking strategy

6. Programmatic SEO

Command	What it does
/seo programmatic plan	Scale content: data sources, templates, quality gates, index control
/seo competitor-pages generate	X vs Y comparisons, alternatives pages, feature matrices

7. Monitoring

Command	What it does
/seo monitor overview	Monitor your site: rankings, clicks, CTR, position changes (GSC)
/seo serp check <keyword>	Live SERP check for any keyword (DataForSEO)
/seo ai-visibility domain <domain>	Track mentions in ChatGPT, Claude, Perplexity, AI Overview (DataForSEO)

8. Local SEO

Command	What it does
/seo local <business> <url>	GBP audit, NAP consistency, reviews, local schema, competitor benchmarking, Ask Maps optimization

9. Data

Command	What it does
/seo keywords research <seed>	Ideas, volume, difficulty, intent, trends (DataForSEO)
/seo keywords site <domain>	Keywords a site ranks for (DataForSEO)
/seo keywords gap <domain> <competitor>	Find keyword opportunities (DataForSEO)

---

Command → Skill Routing

Command	Loads Skill
page	30x-seo-page
technical	30x-seo-technical
sitemap	30x-seo-sitemap
hreflang	30x-seo-hreflang
schema	30x-seo-schema
geo-technical	30x-seo-geo-technical
internal-links	30x-seo-internal-links
backlinks	30x-seo-backlinks
redirects	30x-seo-redirects
content-audit	30x-seo-content-audit
images	30x-seo-images
content-decay	30x-seo-content-decay
cannibalization	30x-seo-cannibalization
content-brief	30x-seo-content-brief
content-writer	30x-seo-content-writer
plan	30x-seo-plan
architecture	30x-seo-architecture
programmatic	30x-seo-programmatic
competitor-pages	30x-seo-competitor-pages
monitor	30x-seo-monitor
serp	30x-seo-serp
ai-visibility	30x-seo-ai-visibility
keywords	30x-seo-keywords
local	30x-seo-local
audit	squirrelscan (CLI) + subagents

---

Orchestration Logic

MANDATORY: /seo audit Execution Order

CRITICAL: When user says "audit", "full audit", "SEO audit", or /seo audit, you MUST follow this exact sequence. Do NOT skip Step 1. Do NOT jump directly to sub-skills.

Step 1 — Squirrelscan (BLOCKING — run this BEFORE anything else):

which squirrelscan && squirrelscan audit <url> --format llm

• If installed: run it FIRST, wait for results, then proceed to Step 2
• If NOT installed: tell user npm i -g squirrelscan to get 230+ rule full-site scan, then proceed to Step 2
• This step provides the global health score (0-100) that frames the entire audit

Step 2 — Industry Detection: Detect business type from homepage (SaaS, local, ecommerce, publisher, agency, other)

Step 3 — Local Business Check: If local business detected → also trigger 30x-seo-local for GBP/Maps/Ask Maps audit

Step 4 — Spawn Sub-Skill Agents (parallel): technical, content, schema, sitemap, performance, visual

Step 5 — Unified Report: Combine squirrelscan score + sub-skill results into SEO Health Score (0-100)

Step 6 — Action Plan: Prioritized: Critical → High → Medium → Low

---

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

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

---

Scoring Methodology

SEO Health Score (0-100)

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)
• High: Significantly impacts rankings (fix within 1 week)
• Medium: Optimization opportunity (fix within 1 month)
• Low: Nice to have (backlog)

---

Sub-Skills (24 Total, 9 Categories)

1. Audit (1 skill + CLI)

Skill	What it does
30x-seo-page	Deep single-page analysis
squirrelscan (CLI)	Full-site 230+ rules audit

2. Technical SEO (5 skills)

Skill	What it does
30x-seo-technical	8-category technical audit
30x-seo-sitemap	Sitemap validation and generation
30x-seo-hreflang	International SEO / hreflang
30x-seo-schema	Schema.org JSON-LD
30x-seo-geo-technical	AI crawler management

3. Links (3 skills)

Skill	What it does
30x-seo-internal-links	Internal link analysis
30x-seo-backlinks	Backlink profile (DataForSEO)
30x-seo-redirects	Redirect chain analysis

4. Content (6 skills)

Skill	What it does
30x-seo-content-audit	E-E-A-T + AI citability
30x-seo-images	Image optimization
30x-seo-content-decay	Content freshness analysis
30x-seo-cannibalization	Keyword conflict detection
30x-seo-content-brief	SERP-based content briefs
30x-seo-content-writer	SEO writing guidelines

5. Planning (2 skills)

Skill	What it does
30x-seo-plan	Strategic SEO planning
30x-seo-architecture	Site structure planning

6. Programmatic SEO (2 skills)

Skill	What it does
30x-seo-programmatic	Scale content with templates
30x-seo-competitor-pages	X vs Y comparison pages

7. Monitoring (3 skills)

Skill	What it does
30x-seo-monitor	Your site via GSC
30x-seo-serp	Any site via DataForSEO
30x-seo-ai-visibility	AI search visibility

8. Local SEO (1 skill)

Skill	What it does
30x-seo-local	GBP audit, NAP, reviews, local schema, competitors, Ask Maps, AI Local Pack

9. Data (1 skill)

Skill	What it does
30x-seo-keywords	Keyword research (DataForSEO)

---

Dependencies

Category	Skills	Dependency
Audit	1	WebFetch
Technical SEO	5	WebFetch
Links	3	WebFetch + DataForSEO (backlinks)
Content	6	WebFetch
Planning	2	WebFetch
Programmatic SEO	2	WebFetch
Local SEO	1	WebFetch
Monitoring	3	GSC + DataForSEO
Data	1	DataForSEO

19 skills work without any API. 4 skills require DataForSEO. 1 skill requires Google Search Console.

---

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