All skills
agricidaniel avatar

/seo-geo

@ff87fce
by Agrici.Danielagricidaniel/claude-seo18k stars
2,665

Audit and improve content for AI Overviews and answer engines, including citability, entity clarity, crawler access, brand signals, and passage structure.

Use this Skill: https://skilld.dev/gh/agricidaniel/claude-seo/seo-geo

This session only. Nothing lands on disk.

referencesgoogle-ai-optimization-guide.md

≈1.8k tokens on demand. Your agent reads this file only when SKILL.md points to it.

Google AI Optimization Guide: primary-source synthesis (September 2026)

Google published a dedicated AI optimization guide under Search Central docs (under the new "Generative AI fundamentals" section; announced via the Search Central blog 2026-05-15, doc last updated 2026-07-10). Its position is the most-cited primary source for how AI Overviews and AI Mode interact with Search ranking. Every claude-seo audit that touches GEO should treat this doc as the canonical reference and reject community claims that contradict it.

Primary source: https://developers.google.com/search/docs/fundamentals/ai-optimization-guide (announcing blog: https://developers.google.com/search/blog/2026/05/a-new-resource-for-optimizing)

Companion doc: third-party SEO tools (2026-06-05): Google published "Using third-party SEO tools, services, and advice." No tool guarantees rankings; third-party tools have no access to Google's internal ranking data; Google does not endorse vendors; evaluate AEO/GEO claims against official guidance; Search Console is the authoritative first-party source. claude-seo's scores are heuristics, not Google-internal signals; state this honestly in reports. Source: https://developers.google.com/search/docs/fundamentals/third-party-seo

TL;DR

"From Google Search's perspective, optimizing for generative AI search is optimizing for the search experience, and thus still SEO." (Google, AI optimization guide)

Google treats "AEO" and "GEO" as other names for the same work and points to its guidance on evaluating third-party SEO advice.

AI Overviews and AI Mode are grounded in the same ranking and quality systems as classic Search. Two AI techniques layer on top:

  1. RAG / grounding: retrieves indexed pages, generates a response with clickable source links.
  2. Query fan-out: issues multiple related sub-queries and pulls in additional results before answering.

Eligibility floor: a page must be indexed and eligible to be shown with a snippet in Google Search, and the site must be included in Search generative AI features through the Search Console "Search generative AI" control (include is the default; the options are include, exclude or inherit; rolled out to all sites worldwide 2026-08-31, https://support.google.com/webmasters/answer/16908024). The setting is not a ranking signal and not a training control. There is no separate "AI index". Everything that follows is SEO fundamentals applied through this lens.

The myth-busting section (most important)

Google explicitly says you do NOT need to:

Claim Google rejects Source
Create llms.txt or AI-specific markup files AI optimization guide §"Myths"
"Chunk" your content into small pieces for AI Same
Rewrite content for AI with specific phrasings or long-tail keyword variations Same
Chase inauthentic mentions across blogs / forums / videos Same
Over-invest in structured data specifically for AI features Same

What does matter, per Google: unique, non-commodity, first-hand content. Their example contrasts "7 Tips for First-Time Homebuyers" (commodity) with "Why We Waived the Inspection & Saved Money: A Look Inside the Sewer Line" (lived experience).

Cross-reference: the llms.txt myth is independently confirmed by [[llmstxt-evidence]] (Mueller, Illyes, SE Ranking 300k-domain study, OtterlyAI server-log audit). Both files must stay aligned.

The "creating helpful content" companion guide

The AI optimization guide links to Google's E-E-A-T guidance:

Primary source: https://developers.google.com/search/docs/fundamentals/creating-helpful-content

Key actionable test: Who / How / Why:

  • Who created it: bylines expected where readers expect them; author background pages required for YMYL.
  • How it was created: especially for AI-assisted content; disclose process where readers would reasonably ask.
  • Why it exists: "to help people," not "to attract search clicks."

YMYL ("Your Money or Your Life") topics get extra weight: health, finance, safety. Sept 2025 QRG expanded YMYL to include political / social topics.

Google's listed warning signs to self-audit against:

  • Writing to a target word count (there isn't one)
  • Entering niches with no expertise just for traffic
  • Faking publication-date freshness
  • Mass content churn for "freshness" signals

AI content policy

Primary source: https://developers.google.com/search/blog/2023/02/google-search-and-ai-content (plus the Search Essentials spam policies)

Generative AI content is fine if it meets Search Essentials. It crosses into spam when used to scale low-value pages (QRG §4.6.5 scaled content abuse, §4.6.6 low-effort main content).

Two operational requirements with concrete enforcement surfaces:

  1. Merchant Center: AI-generated product images: must carry IPTC DigitalSourceType: TrainedAlgorithmicMedia metadata. See ${CLAUDE_PLUGIN_ROOT}/skills/seo-images/SKILL.md for the audit + injection pattern.
  2. AI-generated product titles and descriptions: must be separately specified and labeled as AI-generated in the merchant feed.

Forward-looking: agent-friendly pages and WebMCP

The AI optimization guide pivots near the end to AI agents, not just summarizers. Agents interact with sites through three channels: screenshots plus a vision model, raw HTML/DOM, and the browser accessibility tree.

Full audit criteria: ${CLAUDE_PLUGIN_ROOT}/skills/seo-agentic/references/agent-friendly-pages.md (run /seo agentic).

The guide itself does not mention WebMCP (checked 2026-09-23); WebMCP status, consumers and safe patterns are tracked separately in ${CLAUDE_PLUGIN_ROOT}/skills/seo-agentic/references/webmcp.md. The guide does name UCP (Universal Commerce Protocol, open standard co-developed with Shopify, Etsy, Wayfair, Target, Walmart; Google-confirmed reference implementation in AI Mode in Search; ucp.dev lists 2026-08-25 as the latest date-based release, while Google's merchant guide documents 2026-04-08). UCP audit criteria: ${CLAUDE_PLUGIN_ROOT}/skills/seo-ecommerce/references/ucp-universal-commerce-protocol.md.

How claude-seo treats this guide

  1. seo-geo audits cite this URL as the authoritative source whenever the user asks about AEO/GEO frameworks.
  2. The myth-busting list above gates community-sourced AI-SEO recommendations: if a recommendation contradicts Google's stated position, flag it.
  3. Where a third-party claim and Google contradict, claude-seo defers to Google and notes the contradiction explicitly.
  4. seo-ecommerce and seo-images enforce the two operational requirements above for sites using AI to generate product content.

Last verified

2026-06-21. Re-check the source doc each quarter. Update this file whenever:

  • Google publishes new myth-busting / clarification.
  • Any of the linked policy docs revise eligibility or enforcement language.
  • The UCP / WebMCP standards advance (UCP spec 2026-08-25 on ucp.dev, 2026-04-08 in Google's merchant guide; WebMCP status is tracked in ${CLAUDE_PLUGIN_ROOT}/skills/seo-agentic/references/vendor-matrix.md).

Source: SKILL.md on GitHub

1 warning1d5 checks · Risk SAFE
  • Gen Agent Trust Hub1d

    The seo-geo skill performs content audits for AI search engines. It includes functionality to check for SEO updates via internal scripts and processes user-provided URLs, which introduces a surface for indirect prompt injection from external site content. No malicious behavior was detected.

  • Socket1d

    No alerts

  • Snyk1d

    Risk: MEDIUM · 1 issue

  • Runlayer6mo

    1 file scanned · No issues

  • ZeroLeaks5mo

    Score: 93/100 · 2 sections analyzed

Signed by skilld at ff87fce. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub 3 days ago.

Activeupdated 3 days ago
user-invocable
true
argument-hint
[url]
metadata
{
  "author": "AgriciDaniel",
  "version": "2.4.1",
  "category": "seo"
}
  • SEO
  • ai-search
  • geo
  • ai-overviews
  • chatgpt
  • perplexity
  • content-optimization
  • brand-mentions
  • citability

README badge

README badge for agricidaniel/claude-seo/seo-geo

Analyzes web content for AI search visibility across Google AI Overviews, ChatGPT, and Perplexity by scoring citability, structural readability, brand mentions, and AI crawler access. Focuses on passage-level optimization (134-167 word citable blocks) and platform-specific citation patterns rather than traditional SEO metrics.

Generated from the current SKILL.md.

Does this skill work with platforms other than Google AI Overviews?
Yes. The skill analyzes optimization for Google AI Overviews, Google AI Mode, ChatGPT web search, Perplexity, and Bing Copilot. Each platform has different citation sources and optimization priorities — the skill provides platform-specific scores and recommendations for each.
What's the difference between AI Overviews and AI Mode?
Google AI Overviews are ranking-correlated and cite pages that already rank well in traditional search. AI Mode uses Gemini 3.5 Flash and draws from a broader pool where freshness and entity authority matter more than ranking position. They cite the same URLs only 13.7% of the time for identical queries.
Does this skill check for server-side rendering?
Yes. The skill analyzes whether content is server-side rendered or client-only JavaScript. AI crawlers do not execute JavaScript, so the skill flags JavaScript-dependent content as inaccessible to AI indexing.
What's the optimal content length for AI citations?
Passage-level citability is strongest between 134-167 words, with the direct answer front-loaded in the first 40-60 words of a section. About 44% of AI citations come from content in the first 30% of a page.
Does brand presence matter more than backlinks for AI visibility?
Yes. Brand mentions correlate 3x more strongly with AI citations than backlinks. YouTube mentions show the highest correlation (~0.737), followed by Reddit and Wikipedia, while domain rating (backlinks) correlates weakly (~0.266).

Generated from the current SKILL.md. These answers refresh after source changes.