Seo

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

2. Technical SEO

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

3. Links

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

4. Content

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

5. Planning

| Command | What it does | |---------|-------------| | /seo plan | Competitor analysis, keyword strategy, content calendar, 4-phase roadmap | | /seo architecture | 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 | Live SERP check for any keyword (DataForSEO) | | /seo ai-visibility domain | Track mentions in ChatGPT, Claude, Perplexity, AI Overview (DataForSEO) |

8. Local SEO

| Command | What it does | |---------|-------------| | /seo local | GBP audit, NAP consistency, reviews, local schema, competitor benchmarking, Ask Maps optimization |

9. Data

| Command | What it does | |---------|-------------| | /seo keywords research | Ideas, volume, difficulty, intent, trends (DataForSEO) | | /seo keywords site | Keywords a site ranks for (DataForSEO) | | /seo keywords gap | 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  --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

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: norahe0304-art
• Source: norahe0304-art/30x-seo
• License: MIT

Install and usage instructions live in the source repository linked above.