Agent skill

SEO Geo

by AgriciDaniel in AgriciDaniel/codex-seo

Optimize content for AI Overviews (formerly SGE), ChatGPT web search, Perplexity, and other AI-powered search experiences.

MITAuto-check passedMarketing & SEO

Install SEO Geo

skills CLI
$ npx skills add AgriciDaniel/codex-seo --skill seo-geo -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install AgriciDaniel/codex-seo seo-geo --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/AgriciDaniel/codex-seo.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/seo-geo .claude/skills/seo-geo && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
seo-geo
GitHub stars
799
Used in
2 other repos
Token cost
~2.5k tokens
SKILL.md length
1,078 words
Files
2
Skills in repo
18
Repo updated
First seen
Licence
MIT

At a glance

Optimize content for AI Overviews (formerly SGE), ChatGPT web search, Perplexity, and other AI-powered search experiences.

  • Works in 5 steps: Citability Score (25%) → Structural Readability (20%) → Multi-Modal Content (15%) → …
  • User says AI Overviews
  • SKILL.md covers Shared Data Cache, Key Statistics, Critical Insight: Brand… and GEO Analysis Criteria (Updated), plus 12 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

SEO Geo is an agent skill from AgriciDaniel/codex-seo. Optimize content for AI Overviews (formerly SGE), ChatGPT web search, Perplexity, and other AI-powered search experiences. Generative Engine Optimization (GEO) analysis including brand mention signals, AI crawler accessibility, llms.txt compliance, passage-level citability scoring, and platform-specific optimization. Use when user says "AI Overviews", "SGE", "GEO", "AI search", "LLM optimization", "Perplexity", "AI citations", "ChatGPT search", or "AI visibility".

Its SKILL.md is about 2.5k tokens, which your agent loads only when the skill is triggered. The skill folder holds 1 other file.

It sits in Marketing & SEO, covering AI search optimization. It works with OpenAI and Perplexity. The repository describes itself as: Codex-first SEO skill suite. 26 workflows, 24 TOML agents, DataForSEO/Gemini/Google/Firecrawl integrations, GEO/AEO, CWV, schema, backlinks, local/maps, and deterministic reports. The licence is MIT.

When your agent uses it

  • User says AI Overviews
  • LLM optimization

Example prompts

  • “AI Overviews”
  • “AI search”
  • “LLM optimization”
  • “/seo-geo”

Workflow steps

5 steps, taken from the step headings in SKILL.md.

  1. Citability Score (25%)
  2. Structural Readability (20%)
  3. Multi-Modal Content (15%)
  4. Authority & Brand Signals (20%)
  5. Technical Accessibility (20%)

What it can do on your machine

Read from SKILL.md and the folder at commit 9a644f6. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

SEO Geo loads about 2.5k tokens when it runs. Until then it costs about 119 tokens; SKILL.md has 1,078 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~119
When it runs · the whole SKILL.md, loaded when a task matches
~2.5k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from AgriciDaniel/codex-seo at commit 9a644f6, republished under its MIT licence (© AgriciDaniel). 1,078 words, ~2,459 tokens.

Download SKILL.mdSave it as .claude/skills/seo-geo/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
seo-geo
description
Optimize content for AI Overviews (formerly SGE), ChatGPT web search, Perplexity, and other AI-powered search experiences. Generative Engine Optimization (GEO) analysis including brand mention signals, AI crawler accessibility, llms.txt compliance, passage-level citability scoring, and platform-specific optimization. Use when user says "AI Overviews", "SGE", "GEO", "AI search", "LLM optimization", "Perplexity", "AI citations", "ChatGPT search", or "AI visibility".
user-invokable
true
argument-hint
[url]
license
MIT
metadata.author
AgriciDaniel
metadata.version
1.9.6
metadata.category
seo

AI Search / GEO Optimization (February 2026)

Shared Data Cache

Step 0 -- Check shared data cache:

Before gathering, check .seo-cache/ for reusable context from related SEO skills. Reference: ../seo/references/shared-data-cache.md for schemas and dependency map.

Check these cache files when present:

  • .seo-cache/site-meta.json for domain, business type, industry, and crawl context

  • .seo-cache/audit-scores.json for prior full-audit priorities

  • .seo-cache/pages/{url-slug}/page-analysis.json for page-level context when a URL is provided

  • If found: parse and use clearly valid fields (note "Using cached [X] from [date]")

  • If missing, corrupt, or irrelevant: continue with fresh evidence

  • If the user says "refresh" or "re-run": ignore cache reads and overwrite on write

Key Statistics

MetricValueSource
AI Overviews reach1.5 billion users/month across 200+ countriesGoogle
AI Overviews query coverage50%+ of all queriesIndustry data
AI-referred sessions growth527% (Jan-May 2025)SparkToro
ChatGPT weekly active users900 millionOpenAI
Perplexity monthly queries500+ millionPerplexity

Brand mentions correlate 3x more strongly with AI visibility than backlinks. (Ahrefs December 2025 study of 75,000 brands)

SignalCorrelation with AI Citations
YouTube mentions~0.737 (strongest)
Reddit mentionsHigh
Wikipedia presenceHigh
LinkedIn presenceModerate
Domain Rating (backlinks)~0.266 (weak)

Only 11% of domains are cited by both ChatGPT and Google AI Overviews for the same query, so platform-specific optimization is essential.


GEO Analysis Criteria (Updated)

1. Citability Score (25%)

Optimal passage length: 134-167 words for AI citation.

Strong signals:

  • Clear, quotable sentences with specific facts/statistics
  • Self-contained answer blocks (can be extracted without context)
  • Direct answer in first 40-60 words of section
  • Claims attributed with specific sources
  • Definitions following "X is..." or "X refers to..." patterns
  • Unique data points not found elsewhere

Weak signals:

  • Vague, general statements
  • Opinion without evidence
  • Buried conclusions
  • No specific data points
2. Structural Readability (20%)

92% of AI Overview citations come from top-10 ranking pages, but 47% come from pages ranking below position 5, demonstrating different selection logic.

Strong signals:

  • Clean H1->H2->H3 heading hierarchy
  • Question-based headings (matches query patterns)
  • Short paragraphs (2-4 sentences)
  • Tables for comparative data
  • Ordered/unordered lists for step-by-step or multi-item content
  • FAQ sections with clear Q&A format

Weak signals:

  • Wall of text with no structure
  • Inconsistent heading hierarchy
  • No lists or tables
  • Information buried in paragraphs
3. Multi-Modal Content (15%)

Content with multi-modal elements sees 156% higher selection rates.

Check for:

  • Text + relevant images
  • Video content (embedded or linked)
  • Infographics and charts
  • Interactive elements (calculators, tools)
  • Structured data supporting media
4. Authority & Brand Signals (20%)

Strong signals:

  • Author byline with credentials
  • Publication date and last-updated date
  • Citations to primary sources (studies, official docs, data)
  • Organization credentials and affiliations
  • Expert quotes with attribution
  • Entity presence in Wikipedia, Wikidata
  • Mentions on Reddit, YouTube, LinkedIn

Weak signals:

  • Anonymous authorship
  • No dates
  • No sources cited
  • No brand presence across platforms
5. Technical Accessibility (20%)

AI crawlers do NOT execute JavaScript. Server-side rendering is critical.

Check for:

  • Server-side rendering (SSR) vs client-only content
  • AI crawler access in robots.txt
  • llms.txt file presence and configuration
  • RSL 1.0 licensing terms

AI Crawler Detection

Check robots.txt for these AI crawlers:

CrawlerOwnerPurpose
GPTBotOpenAIChatGPT web search
OAI-SearchBotOpenAIOpenAI search features
ChatGPT-UserOpenAIChatGPT browsing
ClaudeBotAnthropicClaude web features
PerplexityBotPerplexityPerplexity AI search
CCBotCommon CrawlTraining data (often blocked)
anthropic-aiAnthropicClaude training
BytespiderByteDanceTikTok/Douyin AI
cohere-aiCohereCohere models

Recommendation: Allow GPTBot, OAI-SearchBot, ClaudeBot, PerplexityBot for AI search visibility. Block CCBot and training crawlers if desired.


llms.txt Standard

The emerging llms.txt standard provides AI crawlers with structured content guidance.

Location: /llms.txt (root of domain)

Format:

# Title of site
> Brief description

## Main sections
- [Page title](url): Description
- [Another page](url): Description

## Optional: Key facts
- Fact 1
- Fact 2

Check for:

  • Presence of /llms.txt
  • Structured content guidance
  • Key page highlights
  • Contact/authority information

RSL 1.0 (Really Simple Licensing)

New standard (December 2025) for machine-readable AI licensing terms.

Backed by: Reddit, Yahoo, Medium, Quora, Cloudflare, Akamai, Creative Commons

Check for: RSL implementation and appropriate licensing terms.


Show full SKILL.md (452 more words)Show less

Platform-Specific Optimization

PlatformKey Citation SourcesOptimization Focus
Google AI OverviewsTop-10 ranking pages (92%)Traditional SEO + passage optimization
ChatGPTWikipedia (47.9%), Reddit (11.3%)Entity presence, authoritative sources
PerplexityReddit (46.7%), WikipediaCommunity validation, discussions
Bing CopilotBing index, authoritative sitesBing SEO, IndexNow

Output

Generate GEO-ANALYSIS.md with:

  1. GEO Readiness Score: XX/100
  2. Platform breakdown (Google AIO, ChatGPT, Perplexity scores)
  3. AI Crawler Access Status (which crawlers allowed/blocked)
  4. llms.txt Status (present, missing, recommendations)
  5. Brand Mention Analysis (presence on Wikipedia, Reddit, YouTube, LinkedIn)
  6. Passage-Level Citability (optimal 134-167 word blocks identified)
  7. Server-Side Rendering Check (JavaScript dependency analysis)
  8. Top 5 Highest-Impact Changes
  9. Schema Recommendations (for AI discoverability)
  10. Content Reformatting Suggestions (specific passages to rewrite)

Quick Wins

  1. Add "What is [topic]?" definition in first 60 words
  2. Create 134-167 word self-contained answer blocks
  3. Add question-based H2/H3 headings
  4. Include specific statistics with sources
  5. Add publication/update dates
  6. Implement Person schema for authors
  7. Allow key AI crawlers in robots.txt

Medium Effort

  1. Create /llms.txt file
  2. Add author bio with credentials + Wikipedia/LinkedIn links
  3. Ensure server-side rendering for key content
  4. Build entity presence on Reddit, YouTube
  5. Add comparison tables with data
  6. Implement FAQ sections (structured, not schema for commercial sites)

High Impact

  1. Create original research/surveys (unique citability)
  2. Build Wikipedia presence for brand/key people
  3. Establish YouTube channel with content mentions
  4. Implement comprehensive entity linking (sameAs across platforms)
  5. Develop unique tools or calculators

DataForSEO Integration (Optional)

If DataForSEO MCP tools are available, use ai_optimization_chat_gpt_scraper to check what ChatGPT web search returns for target queries (real GEO visibility check) and ai_opt_llm_ment_search with ai_opt_llm_ment_top_domains for LLM mention tracking across AI platforms.

Error Handling

ScenarioAction
URL unreachable (DNS failure, connection refused)Report the error clearly. Do not guess site content. Suggest the user verify the URL and try again.
AI crawlers blocked by robots.txtReport exactly which crawlers are blocked and which are allowed. Provide specific robots.txt directives to add for enabling AI search visibility.
No llms.txt foundNote the absence and provide a ready-to-use llms.txt template based on the site's content structure.
No structured data detectedReport the gap and provide specific schema recommendations (Article, Organization, Person) for improving AI discoverability.

FLOW Framework Integration

For prompt-guided AI content optimization, use /seo flow optimize <url> — FLOW's 21 optimize-stage prompts complement GEO's citability and structure analysis with evidence-led AI prompts.

Write to shared data cache

After completing all work, write a concise JSON summary to .seo-cache/ when the workflow produced durable findings. Use the schemas and naming rules in ../seo/references/shared-data-cache.md; include at least cache_type, analyzed_at, source URL/domain, key findings, issues, recommendations, and tool limitations. Add .seo-cache/ to .gitignore if it is missing.

© AgriciDaniel, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file in skills/seo-geo of AgriciDaniel/codex-seo.

  • SKILL.md
  • LICENSE.txt

Open the folder on GitHubat commit 9a644f6

Used in 3 other repositories

We found 4 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 2 other GitHub owners. This page covers the copy in AgriciDaniel/codex-seo, which our catalogue first saw on October 7, 2026.

Compare with similar skills

SEO Geo next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

SEO Geo compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
SEO Geo this skillAgriciDaniel/codex-seo7992 repos~2.5kAutomated safety check: PassMIT
Geo Fundamentalswasp-lang/wasp19k9 repos~861Automated safety check: PassMIT
SEO GeoReScienceLab/opc-skills1.8k4 repos~2.1kAutomated safety check: PassApache-2.0
GEO-First SEO Audit Toolzubair-trabzada/geo-seo-claude11k—~2.8kAutomated safety check: NotesMIT
Fire Your SEO Agencyleopard627/fire-your-seo-agency711—~1.1kAutomated safety check: PassMIT
Marketing OsYuzzyuk/marketing-os540—~2.5kAutomated safety check: PassMIT

Similar skills

  • Geo Fundamentals

    wasp-lang/wasp

    Generative Engine Optimization for AI search engines (ChatGPT, Claude, Perplexity).

    19k GitHub starsUsed in 9 repos~861 tokens
    Marketing & SEOAuto-check passed
  • SEO Geo

    ReScienceLab/opc-skills

    SEO & GEO (Generative Engine Optimization) for websites. An agent skill from ReScienceLab/opc-skills.

    1.8k GitHub starsUsed in 4 repos~2.1k tokens
    Marketing & SEOAuto-check passed
  • GEO-First SEO Audit Tool

    zubair-trabzada/geo-seo-claude

    Audits a website for AI search visibility across ChatGPT, Claude, Perplexity and Google AI Overviews while checking traditional SEO, schema and E-E-A-T content quality.

    11k GitHub stars~2.8k tokensUpdated yesterday
    Marketing & SEOAuto-check: notes
  • Fire Your SEO Agency

    leopard627/fire-your-seo-agency

    SEO·AEO·GEO·LLMO·NEO(네이버) 다섯 레인을 진단하고 직접 구현하며, 인용되는 콘텐츠를 계속 생산하는 서브 블로그·콘텐츠 운영 파이프라인까지 세팅하는 스킬.

    711 GitHub stars~1.1k tokensUpdated 15 days ago
    Marketing & SEOAuto-check passed
  • Marketing Os

    Yuzzyuk/marketing-os

    A complete marketing department in one skill. An agent skill from Yuzzyuk/marketing-os.

    540 GitHub stars~2.5k tokensUpdated 1 mo ago
    Marketing & SEOAuto-check passed
  • AI Visibility

    Ryze-AI-Adgent/open-seo-mcp-skills

    Measure real AI-engine visibility — traffic from ChatGPT, Perplexity, Claude, Gemini and which pages they cite — from actual GA4 referral data, not prompt sampling.

    4.7k GitHub stars~611 tokensUpdated 17 days ago
    Marketing & SEOAuto-check passed

More from AgriciDaniel/codex-seo

All 18 skills in this repo
  • SEO Google

    AgriciDaniel/codex-seo

    Google SEO APIs: Search Console (Search Analytics, URL Inspection, Sitemaps), PageSpeed Insights v5, CrUX field data with 25-week history, Indexing API v3, and GA4 organic traffic.

    799 GitHub starsUsed in 2 repos~3.4k tokens
    Auto-check passed
  • SEO Dataforseo

    AgriciDaniel/codex-seo

    Live SEO data via DataForSEO MCP server. An agent skill from AgriciDaniel/codex-seo.

    799 GitHub starsUsed in 2 repos~4.6k tokens
    Auto-check passed
  • SEO Ecommerce

    AgriciDaniel/codex-seo

    E-commerce SEO analysis: Google Shopping visibility, Amazon marketplace intelligence, product schema validation, competitor pricing analysis, and marketplace keyword gaps.

    799 GitHub starsUsed in 2 repos~3k tokens
    Auto-check passed
  • SEO Sxo

    AgriciDaniel/codex-seo

    Search Experience Optimization: reads Google SERPs backwards to detect page-type mismatches, derives user stories from search intent signals, and scores pages from multiple persona perspectives.

    799 GitHub starsUsed in 2 repos~2.9k tokens
    Auto-check passed
  • SEO Page

    AgriciDaniel/codex-seo

    Deep single-page SEO analysis covering on-page elements, content quality, technical meta tags, schema, images, and performance.

    799 GitHub starsUsed in 5 repos~1.2k tokens
    Auto-check passed
  • SEO Schema

    AgriciDaniel/codex-seo

    Detect, validate, and generate Schema.org structured data. An agent skill from AgriciDaniel/codex-seo.

    799 GitHub starsUsed in 5 repos~1.6k tokens
    Auto-check passed

Categories

Questions about SEO Geo

What does SEO Geo do?

Optimize content for AI Overviews (formerly SGE), ChatGPT web search, Perplexity, and other AI-powered search experiences. SEO Geo is an agent skill from AgriciDaniel/codex-seo. Optimize content for AI Overviews (formerly SGE), ChatGPT web search, Perplexity, and other AI-powered search experiences.

When should I use SEO Geo?

SEO Geo fits situations like: user says AI Overviews; LLM optimization.

How do I install SEO Geo in Claude Code?

Run `npx skills add AgriciDaniel/codex-seo --skill seo-geo -a claude-code`. Or copy the skill folder (skills/seo-geo in AgriciDaniel/codex-seo) into .claude/skills/seo-geo in your project. Claude Code loads it when a task matches its description.

How do I install SEO Geo in Codex?

Run `npx skills add AgriciDaniel/codex-seo --skill seo-geo -a codex`. Or copy the skill folder (skills/seo-geo in AgriciDaniel/codex-seo) into .agents/skills/seo-geo in your project. Codex loads it when a task matches its description.

Can I use SEO Geo in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add AgriciDaniel/codex-seo --skill seo-geo -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/seo-geo, .gemini/skills/seo-geo, .github/skills/seo-geo and .opencode/skills/seo-geo in your project.

What does SEO Geo need to run?

SKILL.md names no scripts, command-line tools or credentials: SEO Geo is instructions for the agent only.

Does SEO Geo access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is SEO Geo safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does SEO Geo use?

SEO Geo is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does SEO Geo use?

About 2.5k tokens (SKILL.md is roughly 9.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to SEO Geo?

Skills that share tags, products or a category with SEO Geo: Geo Fundamentals (wasp-lang/wasp, 19k stars), SEO Geo (ReScienceLab/opc-skills, 1.8k stars), GEO-First SEO Audit Tool (zubair-trabzada/geo-seo-claude, 11k stars) and Fire Your SEO Agency (leopard627/fire-your-seo-agency, 711 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains SEO Geo?

AgriciDaniel (a GitHub user) maintains it in AgriciDaniel/codex-seo, which has 799 GitHub stars. The repository holds 18 skills in this directory. The repository was last updated on September 11, 2026.

Source: AgriciDaniel/codex-seo on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.