Dotclaude seo-geo

Use when the user wants to improve website search visibility, AI search visibility, schema markup, indexing, metadata, or keyword targeting.

install
source · Clone the upstream repo
git clone https://github.com/JHostalek/dotclaude
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/JHostalek/dotclaude "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/seo-geo" ~/.claude/skills/jhostalek-dotclaude-seo-geo && rm -rf "$T"
manifest: skills/seo-geo/SKILL.md
source content

target = $ARGUMENTS

Optimize the target website for both traditional search engines and AI search engines.

The Shift: SEO to GEO

Traditional SEO optimizes for ranking in search results. GEO (Generative Engine Optimization) optimizes for being cited by AI search engines — ChatGPT, Perplexity, Google AI Overview, Copilot, Claude. Being cited is the new ranking #1.

This distinction matters because the optimization strategies diverge. Keyword density helps traditional SEO but hurts GEO (-10% visibility). Citations and statistics — irrelevant to traditional ranking — boost GEO visibility by 37-40%. Optimize for both, but recognize when they conflict.

Princeton GEO Methods

Research-backed effectiveness rankings from the Princeton/IIT Delhi GEO study (KDD 2024). The numbers are real measured visibility boosts — use them to prioritize.

MethodBoostWhat it means
Cite Sources+40%Authoritative references with attribution
Statistics+37%Specific numbers and data points
Quotations+30%Expert quotes with attribution
Authoritative Tone+25%Confident, expert language
Easy-to-Understand+20%Simplified complex concepts
Technical Terms+18%Domain-specific terminology
Unique Words+15%Vocabulary diversity
Fluency+15-30%Readability and flow
Keyword Stuffing-10%Actively harmful for GEO

Best combination: Fluency + Statistics. For domain-specific guidance, see references/geo-research.md.

Platform-Specific Knowledge

Each AI platform has a different primary index and ranking quirk. These are empirical findings.

PlatformPrimary IndexKey Differentiator
ChatGPTWeb (Bing-based)Content-Answer Fit is 55% of ranking. 30-day-old content gets 3.2x more citations
PerplexityOwn + GoogleFAQ Schema and PDFs are prioritized. Semantic relevance over keywords
Google AI OverviewGoogleE-E-A-T + structured data. Only 15% overlap with traditional Top 10
CopilotBingMust be Bing-indexed. Microsoft ecosystem (LinkedIn, GitHub) signals help
ClaudeBrave SearchFactual density preferred. Crawl-to-refer ratio is 38,065:1 — extremely selective

Full ranking factors per platform: references/platform-algorithms.md

AI Bot Access

These bot user-agent strings must be allowed in robots.txt for AI visibility. Sites often block them unknowingly.

BotPlatform
GPTBot, ChatGPT-UserOpenAI
PerplexityBotPerplexity
ClaudeBot, anthropic-aiAnthropic
Bingbot, msnbotMicrosoft/Copilot
GooglebotGoogle
Applebot-ExtendedApple

Schema Markup

FAQPage schema provides the single highest GEO impact (+40% AI visibility). Prioritize it over other schema types. For ready-to-use JSON-LD templates (FAQPage, Article, WebPage, SoftwareApplication, Organization, Product, HowTo, BreadcrumbList, LocalBusiness, SpeakableSpecification): references/schema-templates.md

Tools

Scripts (in
scripts/
)

ScriptAPI RequiredPurpose
seo_audit.py <url>
NoTechnical audit: meta tags, robots.txt, sitemap, load time, schema, AI bot access
keyword_research.py <keyword>
DataForSEOKeyword ideas, search volume, difficulty
serp_analysis.py <keyword>
DataForSEOTop 20 Google results analysis
backlinks.py <domain>
DataForSEOBacklink profile
domain_overview.py <domain>
DataForSEODomain metrics, traffic, rankings
autocomplete_ideas.py <keyword>
DataForSEOAutocomplete suggestions
competitor_gap.py <domains>
DataForSEOKeyword gap analysis
related_keywords.py <keyword>
DataForSEORelated keyword suggestions

DataForSEO scripts require

DATAFORSEO_LOGIN
and
DATAFORSEO_PASSWORD
environment variables.

Validation

  • Google Rich Results Test:
    https://search.google.com/test/rich-results?url={encoded_url}
  • Schema.org Validator:
    https://validator.schema.org/?url={encoded_url}

Complementary skills

  • WebSearch for keyword research and competitor analysis
  • twitter / reddit skills for SEO community intelligence

References