$npx -y skills add AgriciDaniel/claude-seo --skill seoComprehensive SEO analysis for any website or business type. Full site audits, single-page analysis, technical SEO (crawlability, indexability, Core Web Vitals with INP), schema markup, content quality (E-E-A-T), image optimization, sitemap analysis, and GEO for AI Overviews/Chat
| 1 | # SEO: Universal SEO Analysis Skill |
| 2 | |
| 3 | **Invocation:** `/seo $1 $2` where `$1` is the command and `$2` is the URL or argument. |
| 4 | |
| 5 | **Runtime:** Run bundled Python tools through `claude-seo run <script.py>`. Plugin |
| 6 | installs expose this command automatically. Repository users run |
| 7 | `./bin/claude-seo`; manual installers rewrite the command to the isolated |
| 8 | launcher path. Never invoke bundled scripts with a bare Python interpreter. |
| 9 | |
| 10 | Comprehensive SEO analysis across all industries (SaaS, local services, |
| 11 | e-commerce, publishers, agencies). Orchestrates 24 sub-skills (21 core + 1 framework |
| 12 | integration + 2 extension mirrors) and 18 sub-agents. A separate optional Firecrawl |
| 13 | extension is also installable (see "Optional Extensions" below). |
| 14 | |
| 15 | ## Quick Reference |
| 16 | |
| 17 | | Command | What it does | |
| 18 | |---------|-------------| |
| 19 | | `/seo audit <url>` | Full website audit with parallel subagent delegation | |
| 20 | | `/seo page <url>` | Deep single-page analysis | |
| 21 | | `/seo sitemap <url or generate>` | Analyze or generate XML sitemaps | |
| 22 | | `/seo schema <url>` | Detect, validate, and generate Schema.org markup | |
| 23 | | `/seo images <url or optimize>` | Image SEO: on-page audit, SERP analysis, file optimization | |
| 24 | | `/seo technical <url>` | Technical SEO audit (9 categories) | |
| 25 | | `/seo content <url>` | E-E-A-T and content quality analysis | |
| 26 | | `/seo content-brief <topic or url>` | Generate detailed SEO content brief with target keywords, outline, internal links | |
| 27 | | `/seo geo <url>` | AI Overviews / Generative Engine Optimization | |
| 28 | | `/seo plan <business-type>` | Strategic SEO planning | |
| 29 | | `/seo programmatic [url\|plan]` | Programmatic SEO analysis and planning | |
| 30 | | `/seo competitor-pages [url\|generate]` | Competitor comparison page generation | |
| 31 | | `/seo local <url>` | Local SEO analysis (GBP, citations, reviews, map pack) | |
| 32 | | `/seo maps [command] [args]` | Maps intelligence (geo-grid, GBP audit, reviews, competitors) | |
| 33 | | `/seo hreflang [url]` | Hreflang/i18n SEO audit and generation | |
| 34 | | `/seo google [command] [url]` | Google SEO APIs (GSC, PageSpeed, CrUX, Indexing, GA4) | |
| 35 | | `/seo backlinks <url>` | Backlink profile analysis (free: Moz, Bing, CC; premium: DataForSEO) | |
| 36 | | `/seo cluster <seed-keyword>` | SERP-based semantic clustering and content architecture | |
| 37 | | `/seo sxo <url>` | Search Experience Optimization: page-type analysis, user stories, personas | |
| 38 | | `/seo drift baseline <url>` | Capture SEO baseline for change monitoring | |
| 39 | | `/seo drift compare <url>` | Compare current state to stored baseline | |
| 40 | | `/seo drift history <url>` | Show drift history over time | |
| 41 | | `/seo ecommerce <url>` | E-commerce SEO: product schema, marketplace intelligence | |
| 42 | | `/seo firecrawl [command] <url>` | Full-site crawling and site mapping (extension) | |
| 43 | | `/seo dataforseo [command]` | Live SEO data via DataForSEO (extension) | |
| 44 | | `/seo image-gen [use-case] <description>` | AI image generation for SEO assets (extension) | |
| 45 | | `/seo flow [stage] [url\|topic]` | FLOW framework: evidence-led prompts for Find, Leverage, Optimize, Win, or Local stages | |
| 46 | | `/seo setup` | Explicitly create or refresh the isolated Python runtime and Chromium | |
| 47 | | `/seo doctor` | Check runtime readiness without changing the system | |
| 48 | |
| 49 | ## Runtime Setup |
| 50 | |
| 51 | Run setup only when the user explicitly invokes `/seo setup` or explicitly asks |
| 52 | to repair dependencies. Execute `claude-seo setup`, report core and Chromium |
| 53 | status separately, and do not fall back to global or user package installation. |
| 54 | For diagnosis, execute `claude-seo doctor --json`; its output intentionally omits |
| 55 | absolute paths and environment values. If any `claude-seo run` command reports |
| 56 | that setup is required, suggest `/seo setup` and do not improvise a `pip install`. |
| 57 | |
| 58 | ## Orchestration Logic |
| 59 | |
| 60 | When the user invokes `/seo audit`, delegate to subagents in parallel: |
| 61 | 1. Detect business type (SaaS, local, ecommerce, publisher, agency, other) |
| 62 | 2. Spawn subagents: seo-technical, seo-content, seo-schema, seo-sitemap, seo-performance, seo-visual, seo-geo |
| 63 | 3. If Google API credentials detected (`claude-seo run google_auth.py --check`), also spawn seo-google agent |
| 64 | 4. If local business detected, also spawn seo-local agent |
| 65 | 5. If local business detected AND DataForSEO MCP available, also spawn seo-maps agent |
| 66 | 6. If backlink APIs detected (`claude-seo run backlinks_auth.py --check`), also spawn seo-backlinks agent |
| 67 | 7. If Firecr |