grey-haven-seo-geo-optimization
SEO/GEO Optimization
Optimize web content for both traditional search engines (Google, Bing) and AI search engines (ChatGPT, Perplexity, Gemini, Copilot, Claude).
GEO = Generative Engine Optimization - Optimizing content to be cited by AI search engines.
Key Insight: AI search engines don't rank pages - they cite sources. Being cited is the new ranking #1.
When to Use
- Auditing a website's SEO/GEO status
- Optimizing content for AI search engine citations
- Implementing or fixing structured data (JSON-LD, Schema.org)
- Researching keywords and competitor strategies
- Ensuring AI bots can crawl your site
- Adding meta tags, Open Graph, Twitter Cards
- Improving content structure for both humans and AI
Don't use for:
- General content writing without SEO focus (use creative-writing skill)
- Backend API performance (use performance-optimizer)
Workflow
digraph seo_geo {
rankdir=TB;
"Audit current state" -> "Keyword research";
"Keyword research" -> "GEO optimization";
"GEO optimization" -> "Traditional SEO";
"Traditional SEO" -> "Validate & monitor";
"Validate & monitor" -> "Audit current state" [label="iterate", style=dashed];
}
Step 1: Website Audit
Get the target URL and analyze current SEO/GEO status.
Quick technical check:
# Check meta tags and schema markup
curl -sL "https://example.com" | grep -E "<title>|<meta name=\"description\"|<meta property=\"og:|application/ld\+json" | head -20
# Check robots.txt - verify AI bots are allowed
curl -s "https://example.com/robots.txt"
# Check sitemap structure
curl -s "https://example.com/sitemap.xml" | head -50
AI bots to verify access for:
| Bot | Service |
|---|---|
| Googlebot | |
| Bingbot | Bing / Copilot |
| PerplexityBot | Perplexity |
| ChatGPT-User | ChatGPT with browsing |
| ClaudeBot / anthropic-ai | Claude |
| GPTBot | OpenAI |
Step 2: Keyword Research
Use WebSearch to research target keywords:
{keyword} keyword difficulty site:ahrefs.com OR site:semrush.com{keyword} search volume {current_year}site:{competitor.com} {keyword}
Analyze search volume, difficulty, competitor strategies, long-tail opportunities, and international keyword conflicts.
Step 3: GEO Optimization (AI Search Engines)
Apply the 9 Princeton GEO Methods (see reference/geo-methods.md):
| Method | Boost | Priority |
|---|---|---|
| Cite Sources | +40% | Must-have |
| Statistics Addition | +37% | Must-have |
| Quotation Addition | +30% | Should-have |
| Authoritative Tone | +25% | Should-have |
| Fluency Optimization | +15-30% | Must-have |
| Easy-to-understand | +20% | Should-have |
| Technical Terms | +18% | Context-dependent |
| Unique Words | +15% | Nice-to-have |
| -10% | AVOID |
Best combination: Fluency + Statistics = Maximum boost
Content structure for AI citation:
- "Answer-first" format (direct answer at top)
- Clear H1 > H2 > H3 hierarchy
- Bullet points and numbered lists
- Tables for comparison data
- Short paragraphs (2-3 sentences max)
FAQPage schema adds +40% AI visibility. See templates/schema-faqpage.json.
Step 4: Traditional SEO
Apply meta tags, Open Graph, Twitter Cards, and JSON-LD schema markup. See templates/meta-tags.md for copy-paste templates.
Quick checks:
- H1 contains primary keyword
- Images have descriptive alt text
- Internal links to related content
- External links have
rel="noopener noreferrer" - Mobile-friendly layout
- Page loads in < 3 seconds
Step 5: Validate & Monitor
# Schema validation
open "https://search.google.com/test/rich-results?url={encoded_url}"
open "https://validator.schema.org/?url={encoded_url}"
# Check indexing
open "https://www.google.com/search?q=site:{domain}"
open "https://www.bing.com/search?q=site:{domain}"
Generate report using checklists/seo-geo-audit.md.
Platform-Specific Quick Reference
Each AI search engine has different citation criteria. See reference/platform-optimization.md for full details.
| Platform | Key Factor | Critical Action |
|---|---|---|
| ChatGPT | Domain authority | Update content within 30 days |
| Perplexity | Semantic relevance | FAQPage schema + PDF hosting |
| Google AI Overview | E-E-A-T | Authoritative citations (+132%) |
| Copilot / Bing | Bing indexing | Page speed < 2s |
| Claude | Brave Search | High factual density |
Common Mistakes
| Mistake | Fix |
|---|---|
| Blocking AI bots in robots.txt | Allow PerplexityBot, GPTBot, ClaudeBot explicitly |
| Keyword stuffing | Reduces visibility by 10%. Use natural language. |
| Missing FAQPage schema | Adds +40% AI visibility. Always include for FAQ content. |
| No statistics or citations | GEO research shows +37-40% boost from data and sources |
| Ignoring Brave Search | Claude uses Brave, not Google. Ensure Brave indexing. |
| Stale content | ChatGPT cites 3.2x more from content updated within 30 days |
Collaboration
- Works with:
content-strategistagent (strategy + keyword planning),creative-writingskill (content quality) - Complements: Content strategy with technical SEO implementation and GEO methodology
- Outputs: Optimized markup, schema, audit reports, GEO-enhanced content
Supporting Documentation
-
reference/ - Detailed optimization guides
- geo-methods.md - Princeton GEO research (9 methods in depth)
- platform-optimization.md - Per-platform citation criteria
-
checklists/ - Audit and validation
- seo-geo-audit.md - Complete SEO/GEO audit checklist with report template
-
templates/ - Copy-paste ready markup
- meta-tags.md - Meta tags, Open Graph, Twitter Cards
- schema-faqpage.json - FAQPage JSON-LD template
- schema-templates.md - All JSON-LD schema types
More from greyhaven-ai/claude-code-config
grey-haven-creative-writing
Professional writing assistance for blogs, research articles, fiction, essays, and marketing copy. Use when users want to write, edit, or improve any form of written content. Triggers: 'write a blog', 'write an article', 'help me write', 'write a story', 'write a chapter', 'draft an essay', 'creative writing', 'improve my writing', 'edit my writing', 'write copy', 'content writing'.
139creative-writing
Professional writing assistance for blogs, research articles, fiction, essays, and marketing copy. Use when users want to write, edit, or improve any form of written content. Triggers: 'write a blog', 'write an article', 'help me write', 'write a story', 'write a chapter', 'draft an essay', 'creative writing', 'improve my writing', 'edit my writing', 'write copy', 'content writing'.
33grey-haven-prompt-engineering
Master 26 documented prompt engineering principles for crafting effective LLM prompts with 400%+ quality improvement. Includes templates, anti-patterns, and quality checklists for technical, learning, creative, and research tasks. Use when writing prompts for LLMs, improving AI response quality, training on prompting, designing agent instructions, or when user mentions 'prompt engineering', 'better prompts', 'LLM quality', 'prompt templates', 'AI prompts', 'prompt principles', or 'prompt optimization'.
12grey-haven-ontological-documentation
Create comprehensive ontological documentation for Grey Haven systems - extract domain concepts from TanStack Start and FastAPI codebases, model semantic relationships, generate visual representations of system architecture, and document business domains. Use when onboarding, documenting architecture, or analyzing legacy systems.
12grey-haven-api-design
Design RESTful APIs following Grey Haven standards - FastAPI routes, Pydantic schemas, HTTP status codes, pagination, filtering, error responses, OpenAPI docs, and multi-tenant patterns. Use when creating API endpoints, designing REST resources, implementing server functions, configuring FastAPI, writing Pydantic schemas, setting up error handling, implementing pagination, or when user mentions 'API', 'endpoint', 'REST', 'FastAPI', 'Pydantic', 'server function', 'OpenAPI', 'pagination', 'validation', 'error handling', 'rate limiting', 'CORS', or 'authentication'.
12grey-haven-llm-project-development
Build LLM-powered applications and pipelines using proven methodology - task-model fit analysis, pipeline architecture, structured outputs, file-based state, and cost estimation. Use when building AI features, data processing pipelines, agents, or any LLM-integrated system. Inspired by Karpathy's methodology and production case studies.
11