seo

---
name: seo
description: >
license: MIT
---

# 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)**:
```bash
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