Agent skill
grey-haven-seo-geo-optimization
Use when optimizing web content for search engine visibility, improving AI search engine citations (GEO), auditing website SEO, implementing structured data markup, or researching keyword strategy. Triggers: 'SEO', 'GEO', 'search optimization', 'schema markup', 'meta tags', 'AI search', 'Perplexity', 'search rankings', 'structured data', 'generative engine optimization', 'rich results', 'robots.txt', 'sitemap'.
Install this agent skill to your Project
npx add-skill https://github.com/greyhaven-ai/claude-code-config/tree/main/grey-haven-plugins/creative-writing/skills/seo-geo
SKILL.md
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
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
grey-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'.
grey-haven-tool-design
Design effective MCP tools and Claude Code integrations using the consolidation principle. Fewer, better-designed tools dramatically improve agent success rates. Use when creating MCP servers, designing tool interfaces, optimizing tool sets, or when user mentions 'tool design', 'MCP', 'fewer tools', 'tool consolidation', 'tool architecture', or 'tool optimization'.
grey-haven-documentation-alignment
6-phase verification system ensuring code matches documentation with automated alignment scoring (signature, type, behavior, error, example checks). Reduces onboarding friction 40%. Use when verifying code-docs alignment, onboarding developers, after code changes, pre-release documentation checks, or when user mentions 'docs out of sync', 'documentation verification', 'code-docs alignment', 'docs accuracy', 'documentation drift', or 'verify documentation'.
grey-haven-tdd-orchestration
Master TDD orchestration with multi-agent coordination, strict red-green-refactor enforcement, automated test generation, coverage tracking, and >90% coverage quality gates. Supports Claude Teams for parallel TDD workflows with plan approval gates, or falls back to sequential subagent coordination. Coordinates tdd-python, tdd-typescript, and test-generator agents. Use when implementing features with TDD workflow, coordinating multiple TDD agents, enforcing test-first development, orchestrating TDD teams, or when user mentions 'TDD workflow', 'test-first', 'TDD orchestration', 'multi-agent TDD', 'test coverage', or 'red-green-refactor'.
grey-haven-performance-optimization
Comprehensive performance analysis and optimization for algorithms (O(n²)→O(n)), databases (N+1 queries, indexes), React (memoization, virtual lists), bundles (code splitting), API caching, and memory leaks. 85%+ improvement rate. Use when application is slow, response times exceed SLA, high CPU/memory usage, performance budgets needed, or when user mentions 'performance', 'slow', 'optimization', 'bottleneck', 'speed up', 'latency', 'memory leak', or 'performance tuning'.
grey-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.
Didn't find tool you were looking for?