Now liveThe Skillselion MCP - thousands of ranked skills, loaded into your agent mid-task. No install.Get it →
agricidaniel avatar

Seo Geo

  • 37 installs
  • 548 repo stars
  • Updated July 20, 2026
  • agricidaniel/codex-seo

seo-geo is a Claude Code skill that performs Generative Engine Optimization, scoring and reformatting content so it is cited by AI search engines like AI Overviews, ChatGPT, and Perplexity.

About

seo-geo is a Claude Code skill for Generative Engine Optimization: making content citable by AI search experiences like Google AI Overviews, ChatGPT search, and Perplexity. A developer uses it to score passage-level citability, check server-side rendering and AI-crawler access in robots.txt, verify llms.txt, and audit brand-mention signals. It produces a GEO readiness score with per-platform breakdowns and reformatting suggestions.

  • Scores passage-level citability, structure, and authority for AI search engines
  • Audits AI crawler access (GPTBot, ClaudeBot, PerplexityBot) and llms.txt compliance
  • Gives platform-specific optimization for AI Overviews, ChatGPT, Perplexity, and Bing Copilot

Seo Geo by the numbers

  • 37 all-time installs (skills.sh)
  • Ranked #1,378 of 1,879 Marketing & SEO skills by installs in the Skillselion catalog
  • Data as of Aug 5, 2026 (Skillselion catalog sync)
At a glance

seo-geo capabilities & compatibility

Free; optional DataForSEO MCP integration for live AI-visibility checks if available

Capabilities
citability scoring · ai crawler audit · llms txt check · brand mention audit · ssr check · geo optimization
Use cases
seo · research
Pricing
Free
From the docs

What seo-geo says it does

Optimize content for AI Overviews (formerly SGE), ChatGPT web search, Perplexity, and other AI-powered search experiences.
SKILL.md
**Optimal passage length: 134-167 words** for AI citation.
SKILL.md
**AI crawlers do NOT execute JavaScript.** Server-side rendering is critical.
SKILL.md
npx skills add https://github.com/agricidaniel/codex-seo --skill seo-geo

Add your badge

Show developers this skill is listed on Skillselion. Paste this into your README.

Listed on Skillselion
Installs37
repo stars548
Last updatedJuly 20, 2026
Repositoryagricidaniel/codex-seo

What it does

Optimize a page to get cited by AI Overviews, ChatGPT, and Perplexity via citability scoring and crawler-access checks.

Who is it for?

Making content citable by AI answer engines through citability scoring, crawler-access, and llms.txt checks

Skip if: Traditional Google ranking tasks like Core Web Vitals or keyword volume; those live in sibling skills

When should I use this skill?

user says AI Overviews, SGE, GEO, AI search, LLM optimization, Perplexity, AI citations, or AI visibility

What you get

A GEO readiness score with platform breakdowns, crawler-access status, llms.txt guidance, and specific passage rewrites.

  • GEO-ANALYSIS.md with a GEO readiness score
  • Platform-specific breakdown
  • AI crawler access status

By the numbers

  • Optimal passage length 134-167 words
  • 5 weighted GEO criteria (citability 25%, readability 20%, multi-modal 15%, authority 20%, technical 20%)
  • 10-section GEO-ANALYSIS.md output

Files

SKILL.mdMarkdownGitHub ↗

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

Critical Insight: Brand Mentions > Backlinks

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.

---

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.

Related skills

FAQ

What passage length does seo-geo target for AI citation?

Optimal passage length is 134-167 words for AI citation, formatted as self-contained answer blocks with a direct answer in the first 40-60 words.

Why does server-side rendering matter for GEO?

AI crawlers do NOT execute JavaScript, so client-only content is invisible to them; server-side rendering of key content is critical.

Marketing & SEOseocontent

This week in AI coding

Five minutes, every Monday - the tools, releases and tactics for developers.

unsubscribe anytime.