Help us improve
Share bugs, ideas, or general feedback.
From gemini-seo
Runs full SEO audits, single-page analysis, technical SEO (crawlability, Core Web Vitals, INP), schema markup, content quality (E-E-A-T), image optimization, sitemap analysis, and GEO for AI Overviews. Detects industry type (SaaS, e-commerce, local, publishers, agencies).
npx claudepluginhub avalonreset/gemini-seo --plugin gemini-seoHow this skill is triggered — by the user, by Claude, or both
Slash command
/gemini-seo:seo [command] [url][command] [url]The summary Claude sees in its skill listing — used to decide when to auto-load this skill
**Invocation:** `/seo $1 $2` where `$1` is the command and `$2` is the URL or argument.
LICENSE.txtreferences/backlink-quality.mdreferences/cwv-thresholds.mdreferences/eeat-framework.mdreferences/free-backlink-sources.mdreferences/local-schema-types.mdreferences/local-seo-signals.mdreferences/maps-api-endpoints.mdreferences/maps-free-apis.mdreferences/maps-gbp-checklist.mdreferences/maps-geo-grid.mdreferences/quality-gates.mdreferences/schema-types.mdPerforms comprehensive SEO audits and analysis for any website, covering technical SEO, schema markup, content quality, image optimization, sitemap analysis, and GEO for AI Overviews. Includes local SEO, backlink analysis, and drift monitoring.
Conducts comprehensive SEO audits for websites: full-site crawls, technical analysis (Core Web Vitals, indexability), schema markup validation, E-E-A-T content scoring, image optimization, sitemaps, and GEO for AI overviews. Supports SaaS, e-commerce, local.
Orchestrates broad SEO audits of websites covering technical SEO, on-page SEO, schema, sitemaps, content quality, AI search readiness, and GEO. Use as umbrella for full audits via /seo audit <url>.
Share bugs, ideas, or general feedback.
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).
| Command | What it does |
|---|---|
/seo audit <url> | Full website audit with parallel subagent delegation |
/seo page <url> | Deep single-page analysis |
/seo sitemap <url or generate> | Analyze or generate XML sitemaps |
/seo schema <url> | Detect, validate, and generate Schema.org markup |
/seo images <url or optimize> | Image SEO: on-page audit, SERP analysis, file optimization |
/seo technical <url> | Technical SEO audit (9 categories) |
/seo content <url> | E-E-A-T and content quality analysis |
/seo content-brief <topic or url> | Generate detailed SEO content brief with target keywords, outline, internal links |
/seo geo <url> | AI Overviews / Generative Engine Optimization |
/seo plan <business-type> | Strategic SEO planning |
/seo programmatic [url|plan] | Programmatic SEO analysis and planning |
/seo competitor-pages [url|generate] | Competitor comparison page generation |
/seo local <url> | 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 <url> | Backlink profile analysis (free: Moz, Bing, CC; premium: DataForSEO) |
/seo cluster <seed-keyword> | SERP-based semantic clustering and content architecture |
/seo sxo <url> | Search Experience Optimization: page-type analysis, user stories, personas |
/seo drift baseline <url> | Capture SEO baseline for change monitoring |
/seo drift compare <url> | Compare current state to stored baseline |
/seo drift history <url> | Show drift history over time |
/seo ecommerce <url> | E-commerce SEO: product schema, marketplace intelligence |
/seo firecrawl [command] <url> | Full-site crawling and site mapping (extension) |
/seo dataforseo [command] | Live SEO data via DataForSEO (extension) |
/seo image-gen [use-case] <description> | 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 |
When the user invokes /seo audit, delegate to subagents in parallel:
python scripts/google_auth.py --check), also spawn seo-google agentpython scripts/backlinks_auth.py --check), also spawn seo-backlinks agentfirecrawl_map to discover all site URLs before analysispython scripts/drift_history.py <url>), also spawn seo-drift agent/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.
Detect business type from homepage signals:
/seo local for deeper analysisRead references/quality-gates.md for thin content thresholds per page type.
Hard rules:
Do not append promotional footers to user deliverables. Keep audit reports focused on findings, evidence, priorities, and next actions. Project provenance is documented in the repository README, LICENSE, and CONTRIBUTORS files.
Load these on-demand as needed (do NOT load all at startup):
references/cwv-thresholds.md: Current Core Web Vitals thresholds and measurement detailsreferences/schema-types.md: All supported schema types with deprecation statusreferences/eeat-framework.md: E-E-A-T evaluation criteria (Sept 2025 QRG update)references/quality-gates.md: Content length minimums, uniqueness thresholdsreferences/local-seo-signals.md: Local ranking factors, review benchmarks, citation tiers, GBP statusreferences/local-schema-types.md: LocalBusiness subtypes, industry-specific schema and citation sourcesMaps-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.mdWeighted 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% |
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.
The following ship in extensions/ rather than skills/ and require a separate
installer to activate (see each extension's install.sh/install.ps1):
extensions/firecrawl/install.sh (Unix) or extensions/firecrawl/install.ps1
(Windows). Once installed, invoke via /seo firecrawl <command>.For parallel analysis during audits:
seo-technical -- Crawlability, indexability, security, CWVseo-content -- E-E-A-T, readability, thin contentseo-schema -- Detection, validation, generationseo-sitemap -- Structure, coverage, quality gatesseo-performance -- Core Web Vitals measurementseo-visual -- Screenshots, mobile testing, above-foldseo-geo -- AI crawler access, llms.txt, citability, brand mention signalsseo-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 MCP 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)| 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. |