# SEO > Comprehensive 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/ChatGPT/Perplexity. Industry detection for SaaS, e-commerce, local, publishers, agencies. Triggers on: SEO, audit, schema, Core Web Vitals, sitemap, E-E-A-T, AI Overviews, GEO, technical SEO, content quality, page speed, structured data. - Skill: `thedixitjain/seo-5` (Agent Skill, multi-file: 15 files) - Install (CLI): `npx skillmds add thedixitjain/seo-5` - Raw SKILL.md: https://api.skillmd.com/api/skills/thedixitjain/seo-5/raw - Safety review: pending - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: Marketing & Growth - Author: thedixitjain (https://skillmd.com/u/thedixitjain) - Updated: 2026-09-09 - Page: https://skillmd.com/skills/thedixitjain/seo-5 --- # SEO: Universal SEO Analysis Skill **Invocation:** `/seo $1 $2` where `$1` is the command and `$2` is the URL or argument. **Scripts:** Located at the plugin root `scripts/` directory. Comprehensive SEO analysis across all industries (SaaS, local services, e-commerce, publishers, agencies). Orchestrates 24 sub-skills (21 core + 1 framework integration + 2 extension mirrors) and 18 sub-agents. A separate optional Firecrawl extension is also installable (see "Optional Extensions" below). ## Quick Reference | Command | What it does | |---------|-------------| | `/seo audit ` | Full website audit with parallel subagent delegation | | `/seo page ` | Deep single-page analysis | | `/seo sitemap ` | Analyze or generate XML sitemaps | | `/seo schema ` | Detect, validate, and generate Schema.org markup | | `/seo images ` | Image SEO: on-page audit, SERP analysis, file optimization | | `/seo technical ` | Technical SEO audit (9 categories) | | `/seo content ` | E-E-A-T and content quality analysis | | `/seo content-brief ` | Generate detailed SEO content brief with target keywords, outline, internal links | | `/seo geo ` | AI Overviews / Generative Engine Optimization | | `/seo plan ` | Strategic SEO planning | | `/seo programmatic [url\|plan]` | Programmatic SEO analysis and planning | | `/seo competitor-pages [url\|generate]` | Competitor comparison page generation | | `/seo local ` | Local SEO analysis (GBP, citations, reviews, map pack) | | `/seo maps [command] [args]` | Maps intelligence (geo-grid, GBP audit, reviews, competitors) | | `/seo hreflang [url]` | Hreflang/i18n SEO audit and generation | | `/seo google [command] [url]` | Google SEO APIs (GSC, PageSpeed, CrUX, Indexing, GA4) | | `/seo backlinks ` | Backlink profile analysis (free: Moz, Bing, CC; premium: DataForSEO) | | `/seo cluster ` | SERP-based semantic clustering and content architecture | | `/seo sxo ` | Search Experience Optimization: page-type analysis, user stories, personas | | `/seo drift baseline ` | Capture SEO baseline for change monitoring | | `/seo drift compare ` | Compare current state to stored baseline | | `/seo drift history ` | Show drift history over time | | `/seo ecommerce ` | E-commerce SEO: product schema, marketplace intelligence | | `/seo firecrawl [command] ` | Full-site crawling and site mapping (extension) | | `/seo dataforseo [command]` | Live SEO data via DataForSEO (extension) | | `/seo image-gen [use-case] ` | AI image generation for SEO assets (extension) | | `/seo flow [stage] [url\|topic]` | FLOW framework: evidence-led prompts for Find, Leverage, Optimize, Win, or Local stages | ## Orchestration Logic ### Delegation policy Full audits are speed-first, multi-agent workflows. Launch available specialist agents concurrently whenever the runtime supports delegation; use inline sequential work only as a last-resort compatibility fallback. In SEO Dungeon, delegated agents should inherit the selected strength profile: Warrior/deep uses extra-high or the highest available effort, Samurai/balanced uses high, and Knight/fast uses medium. Do not silently downshift delegated work below the selected profile. When the user invokes `/seo audit`, delegate to subagents in parallel: 1. Detect business type (SaaS, local, ecommerce, publisher, agency, other) 2. Spawn always-on subagents: seo-technical, seo-content, seo-schema, seo-sitemap, seo-performance, seo-visual, seo-geo, seo-sxo 3. If Google API credentials detected (`python3 scripts/google_auth.py --check`), also spawn seo-google agent 4. If local business detected, also spawn seo-local agent 5. If local business detected AND DataForSEO credentials or optional tools are available, also spawn seo-maps agent 6. If backlink APIs detected (`python3 scripts/backlinks_auth.py --check`), also spawn seo-backlinks agent 7. If `FIRECRAWL_API_KEY` or an optional Firecrawl adapter is available, use Firecrawl to discover site URLs before analysis; otherwise fall back to sitemap and page-discovery scripts 8. If content strategy signals detected (blog, pillar pages, topic clusters), also spawn seo-cluster agent 9. If e-commerce detected, also spawn seo-ecommerce agent 10. If drift baseline exists for this URL (`python3 scripts/drift_history.py `), also spawn seo-drift agent 11. Collect results and generate unified report with SEO Health Score (0-100) 12. **Synthesize via the 10-principle framework** (see "Synthesis Methodology" below): walk PERCEIVE -> ANALYZE -> VALIDATE -> ACT before bucketing findings into Critical / High / Medium / Low 13. Create prioritized action plan with dependency sequencing + falsifiability per recommendation 14. **Offer PDF report**: "Generate a professional PDF report? Use `/seo google report full`" For individual commands, load the relevant sub-skill directly. After any analysis command completes, offer to generate a PDF report via `scripts/google_report.py`. ## Synthesis Methodology Audits are not just findings — they are findings synthesized into a coherent strategy. claude-seo uses a 10-principle thinking framework grouped into four phases: **PERCEIVE** (observe-external · observe-internal · listen), **ANALYZE** (think · connect-lateral · connect-system), **VALIDATE** (feel · accept), **ACT** (create · grow). Full audits (`/seo audit`, `/seo page`) walk every phase before emitting the action plan. Narrower commands (`/seo schema`, `/seo images`, etc.) pass at least THINK + ACCEPT before emitting (sound first principle, surfaced falsifiability). The Critical / High / Medium / Low priority buckets are the **output** of validation, not a substitute for it. Full methodology + per-principle SEO mapping: `references/thinking-framework.md`. Each emitted recommendation should carry: - The first-principle observation it rests on (THINK) - The dependency on / unblock relationship to other recommendations (CONNECT-system) - An explicit "how would we know this failed?" check (ACCEPT) - A leading indicator the user can monitor without re-running the audit (GROW) ## 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 --> auto-suggest `/seo local` for deeper analysis - **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 Read `references/quality-gates.md` for thin content thresholds per page type. 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: Google retired FAQ rich results for ALL sites on May 7, 2026 (no SERP feature anymore; supersedes the Aug 2023 gov/health restriction). Flag existing FAQPage at Info (not Critical) for its AI/LLM citation benefit; do not recommend removal; do not recommend new FAQPage for Google SERP benefit; use QAPage for genuine user Q&A - All Core Web Vitals references use INP, never FID ## Reference Files Load these on-demand as needed (do NOT load all at startup): - `references/cwv-thresholds.md`: Current Core Web Vitals thresholds and measurement details - `references/schema-types.md`: All supported schema types with deprecation status - `references/eeat-framework.md`: E-E-A-T evaluation criteria (Sept 2025 QRG update) - `references/quality-gates.md`: Content length minimums, uniqueness thresholds - `references/local-seo-signals.md`: Local ranking factors, review benchmarks, citation tiers, GBP status - `references/local-schema-types.md`: LocalBusiness subtypes, industry-specific schema and citation sources Maps-specific references (loaded by seo-maps skill, not at startup): - `references/maps-geo-grid.md`, `references/maps-gbp-checklist.md`, `references/maps-api-endpoints.md`, `references/maps-free-apis.md` ## Scoring Methodology ### SEO Health Score (0-100) Weighted aggregate of all categories: | Category | Weight | |----------|--------| | Technical SEO | 22% | | Content Quality | 23% | | On-Page SEO | 20% | | Schema / Structured Data | 10% | | Performance (CWV) | 10% | | AI Search Readiness | 10% | | Images | 5% | ### Priority Levels - **Critical**: Blocks indexing or causes penalties (immediate fix required) - **High**: Significantly impacts rankings (fix within 1 week) - **Medium**: Optimization opportunity (fix within 1 month) - **Low**: Nice to have (backlog) ## Sub-Skills This skill orchestrates 24 sub-skills (21 core + 1 framework integration + 2 extension mirrors). The orchestrator itself (`seo`) is the 25th in `skills/`, but does not orchestrate itself, so it is not enumerated below. 1. **seo-audit** -- Full website audit with parallel delegation 2. **seo-page** -- Deep single-page analysis 3. **seo-technical** -- Technical SEO (9 categories) 4. **seo-content** -- E-E-A-T and content quality 5. **seo-content-brief** -- Detailed SEO content brief generation (contributed by puneetindersingh) 6. **seo-schema** -- Schema markup detection and generation 7. **seo-images** -- Image optimization, SERP analysis, file optimization 8. **seo-sitemap** -- Sitemap analysis and generation 9. **seo-geo** -- AI Overviews / GEO optimization 10. **seo-plan** -- Strategic planning with templates 11. **seo-programmatic** -- Programmatic SEO analysis and planning 12. **seo-competitor-pages** -- Competitor comparison page generation 13. **seo-hreflang** -- Hreflang/i18n SEO audit, cultural profiles, content parity 14. **seo-local** -- Local SEO (GBP, NAP, citations, reviews, local schema, multi-location) 15. **seo-maps** -- Maps intelligence (geo-grid, GBP audit, reviews, competitor radius) 16. **seo-google** -- Google SEO APIs (GSC, PageSpeed, CrUX, Indexing API, GA4) 17. **seo-backlinks** -- Backlink profile analysis (free: Moz, Bing, CC; premium: DataForSEO) 18. **seo-cluster** -- SERP-based semantic clustering (contributed by Lutfiya Miller) 19. **seo-sxo** -- Search Experience Optimization (contributed by Florian Schmitz) 20. **seo-drift** -- SEO drift monitoring (contributed by Dan Colta) 21. **seo-ecommerce** -- E-commerce SEO intelligence (contributed by Matej Marjanovic) 22. **seo-dataforseo** -- Live SEO data via DataForSEO credentials (extension mirror) 23. **seo-image-gen** -- AI image generation for SEO assets via Gemini (extension mirror) 24. **seo-flow** -- FLOW framework integration (Find -> Leverage -> Optimize -> Win, 41 AI prompts, CC BY 4.0) ### Optional Extensions The following ship in `extensions/` rather than `skills/`. DataForSEO and Firecrawl should use selected-project `.env` credentials by default; their installers are optional for users who want adapter setup: Of the optional extensions, firecrawl, dataforseo, and image-gen are reachable through `/seo` subcommands. Ahrefs, Bing, Profound, SE Ranking, and Unlighthouse install as standalone skills invoked by their own descriptions. The model auto-routes to those triggers, not through `/seo `. - **seo-firecrawl** -- Full-site crawling and site mapping via Firecrawl credentials. Add `FIRECRAWL_API_KEY` to the selected project `.env`; install the optional adapter only if desired. Invoke via `/seo firecrawl `. ## 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 - `seo-geo` -- AI crawler access, llms.txt, citability, brand mention signals - `seo-local` -- GBP signals, NAP consistency, reviews, local schema, industry-specific local factors (conditional: spawned when Local Service detected) - `seo-maps` -- Geo-grid rank tracking, GBP audit, review intelligence, competitor radius mapping (conditional: spawned when Local Service detected AND DataForSEO credentials/tools are available) - `seo-google` -- CWV field data, URL indexation status, organic traffic trends (conditional: spawned when Google API credentials detected) - `seo-backlinks` -- Backlink profile data: DA/PA, referring domains, anchor text, toxic links (conditional: spawned when Moz/Bing API keys detected or always for CC domain-level metrics) - `seo-cluster` -- Semantic clustering analysis (conditional: content strategy detected) - `seo-sxo` -- Page-type mismatch, user stories, persona scoring (always in full audits) - `seo-drift` -- Baseline comparison (conditional: drift baseline exists for URL) - `seo-ecommerce` -- Product schema, marketplace intel (conditional: e-commerce detected) - `seo-flow` -- FLOW framework prompts (conditional: spawned for content strategy workflows) - `seo-dataforseo` -- Live SERP, keyword, backlink, local SEO data (extension, optional) - `seo-image-gen` -- SEO image audit and generation plan (extension, optional) ## Error Handling | Scenario | Action | |----------|--------| | Unrecognized command | List available commands from the Quick Reference table. Suggest the closest matching command. | | URL unreachable | Report the error and suggest the user verify the URL. Do not attempt to guess site content. | | Sub-skill fails during audit | Report partial results from successful sub-skills. Clearly note which sub-skill failed and why. Suggest re-running the failed sub-skill individually. | | Ambiguous business type detection | Present the top two detected types with supporting signals. Ask the user to confirm before proceeding with industry-specific recommendations. | --- **Source:** [`hashgraph-online/awesome-codex-plugins`](https://github.com/hashgraph-online/awesome-codex-plugins) → `plugins/avalonreset/seo-dungeon/skills/seo/SKILL.md`