Dotclaude seo-geo
Use when the user wants to improve website search visibility, AI search visibility, schema markup, indexing, metadata, or keyword targeting.
git clone https://github.com/JHostalek/dotclaude
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"
skills/seo-geo/SKILL.mdtarget = $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.
| Method | Boost | What 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.
| Platform | Primary Index | Key Differentiator |
|---|---|---|
| ChatGPT | Web (Bing-based) | Content-Answer Fit is 55% of ranking. 30-day-old content gets 3.2x more citations |
| Perplexity | Own + Google | FAQ Schema and PDFs are prioritized. Semantic relevance over keywords |
| Google AI Overview | E-E-A-T + structured data. Only 15% overlap with traditional Top 10 | |
| Copilot | Bing | Must be Bing-indexed. Microsoft ecosystem (LinkedIn, GitHub) signals help |
| Claude | Brave Search | Factual 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.
| Bot | Platform |
|---|---|
| GPTBot, ChatGPT-User | OpenAI |
| PerplexityBot | Perplexity |
| ClaudeBot, anthropic-ai | Anthropic |
| Bingbot, msnbot | Microsoft/Copilot |
| Googlebot | |
| Applebot-Extended | Apple |
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/
)
scripts/| Script | API Required | Purpose |
|---|---|---|
| No | Technical audit: meta tags, robots.txt, sitemap, load time, schema, AI bot access |
| DataForSEO | Keyword ideas, search volume, difficulty |
| DataForSEO | Top 20 Google results analysis |
| DataForSEO | Backlink profile |
| DataForSEO | Domain metrics, traffic, rankings |
| DataForSEO | Autocomplete suggestions |
| DataForSEO | Keyword gap analysis |
| DataForSEO | Related 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
- references/geo-research.md — Princeton GEO research: 9 methods with examples and domain-specific recommendations
- references/platform-algorithms.md — Detailed ranking factors per platform
- references/schema-templates.md — JSON-LD templates for all major schema types
- references/seo-checklist.md — Prioritized audit checklist (P0/P1/P2)
- references/tools-and-apis.md — Tools, APIs, browser extensions
- references/google-docs-summary.md — Google Search Central quick reference
- examples/opc-skills-case-study.md — Real-world optimization example