# seo

> Universal SEO analysis skill that orchestrates 21 specialized sub-skills and 18 subagents for full site audits, single-page analysis, technical SEO, schema markup, content quality, image optimization, local SEO, GEO, and programmatic SEO across any industry type.

**Use case**: Run a full site SEO audit with one command

**Canonical URL**: https://agentcookbooks.com/skills/seo/

**Topics**: claude-code, skills, marketing, seo

**Trigger phrases**: "SEO audit", "full site audit", "SEO analysis", "check my SEO", "site SEO"

**Source**: [AgriciDaniel](https://github.com/AgriciDaniel/claude-seo/tree/main/skills/seo)

**License**: MIT

---

## What it does

`seo` is the orchestrator skill in AgriciDaniel's [claude-seo repo](https://github.com/AgriciDaniel/claude-seo). It is the entry point for the entire claude-seo system — a unified interface that detects the site type, routes to the appropriate sub-skills, and produces a consolidated SEO Health Score (0–100) with a single prioritized action plan across all findings.

The orchestrator manages 21 specialized sub-skills plus 3 optional extensions: seo-technical (9-category technical audit), seo-content (E-E-A-T and content quality), seo-schema (structured data), seo-sitemap, seo-images, seo-geo (AI Overviews and GEO), seo-page (single-page deep dive), seo-plan (strategic planning), seo-programmatic, seo-competitor-pages, seo-hreflang, seo-local, seo-maps, seo-google (Google APIs), seo-backlinks, seo-cluster (SERP-based topic clustering), seo-sxo (Search Experience Optimization), seo-drift (regression monitoring), seo-ecommerce, and seo-flow (FLOW framework). Extensions: seo-dataforseo (DataForSEO MCP), seo-firecrawl (full-site crawling), seo-image-gen (AI image generation).

The scoring model weights seven categories: Technical SEO 22%, Content Quality 23%, On-Page SEO 20%, Schema 10%, Core Web Vitals 10%, AI Search Readiness 10%, Images 5%.

## When to use it

Reach for it when:

- You want a comprehensive site audit and don't want to manually invoke individual sub-skills
- You are onboarding a new client or site and need a full-scope baseline before planning optimization work
- You want the orchestrator to detect industry type automatically (SaaS, local, e-commerce, publisher, agency) and route to the appropriate specialist sub-skills

When *not* to reach for it:

- You know exactly which aspect of SEO you need to address — invoking the specific sub-skill directly is faster and more focused
- The site requires authentication for its key pages — the orchestrator can only analyze publicly accessible content

## Install

Copy the [`seo` SKILL.md](https://github.com/AgriciDaniel/claude-seo/tree/main/skills/seo) into `.claude/skills/seo/` along with all the sub-skill directories and the `scripts/`, `references/`, and `assets/` directories from the repo root.

Trigger phrases: "SEO", "audit", "schema", "Core Web Vitals", "sitemap", "E-E-A-T", "AI Overviews", "GEO", "technical SEO", "content quality", "structured data".

Main commands: `/seo audit <url>` (full parallel subagent audit), `/seo page <url>` (single-page analysis), and all sub-skill commands prefixed with `/seo`.

## What a session looks like

A typical session has three phases:

1. **Industry detection and subagent routing.** The homepage is fetched and classified: SaaS (pricing page, /features, /integrations, "free trial"), Local Service (phone number, address, service area, Maps embed), E-commerce (/products, /cart, "add to cart"), Publisher (/blog, article schema, author pages), Agency (/case-studies, client logos). Based on detection, additional conditional subagents are spawned: `seo-local` and optionally `seo-maps` for local businesses, `seo-ecommerce` for e-commerce, `seo-cluster` if content strategy signals are present, `seo-backlinks` if API keys are detected, `seo-drift` if a baseline exists for the URL. `seo-sxo` is always spawned in full audits.
2. **Parallel subagent execution.** The core subagents (technical, content, schema, sitemap, images, geo) run in parallel. Results are collected and deduplicated — the same finding flagged by two sub-skills is merged into one action item rather than appearing twice.
3. **Unified report and action plan.** The SEO Health Score is calculated from the weighted category breakdown. Findings are consolidated and prioritized Critical > High > Medium > Low. A PDF report is offered via `/seo google report full`. The community footer (AI Marketing Hub links) is appended after major deliverables as specified in the upstream skill.

## Receipts

**Works well:** The industry detection routing is the biggest practical time-saver — a local business audit automatically includes `seo-local` (NAP, citations, GBP signals) and optionally `seo-maps` (geo-grid, review intelligence) without requiring the user to know these sub-skills exist. A first-time user gets the right analysis for their site type without configuration.

**Backfires:** The full audit with all subagents is a lengthy operation — it involves many web fetches, multiple SERP lookups, and API calls if credentials are configured. For a quick check on a single aspect, invoking the specific sub-skill directly is faster by an order of magnitude.

**Pattern that works:** Run `/seo audit` once for the full baseline at the start of an engagement. Use specific sub-skills for subsequent targeted work: `/seo page <url>` for individual pages, `/seo drift compare <url>` after deployments, `/seo cluster <seed>` for content planning. The orchestrator is a baseline tool, not a daily workflow.

## Source and attribution

Originally written by [AgriciDaniel](https://github.com/AgriciDaniel). The canonical SKILL.md and all sub-skills live in the [claude-seo repository](https://github.com/AgriciDaniel/claude-seo).

License: MIT. Install, adapt, and redistribute with attribution preserved.

This page documents the skill from a practitioner's perspective. For the formal spec and updates, defer to the source repo.