seo

Trigger phrases

Phrases that activate this skill when typed to Claude Code:

• SEO audit
• full site audit
• SEO analysis
• check my SEO
• site SEO

What it does

seo is the orchestrator skill in AgriciDaniel’s claude-seo repo. 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 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. The canonical SKILL.md and all sub-skills live in the claude-seo repository.

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.