Skill

grey-haven-seo-geo-optimization

Install
1
Install the plugin
$
npx claudepluginhub greyhaven-ai/claude-code-config --plugin creative-writing

Want just this skill?

Add to a custom plugin, then install with one command.

Description

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'.

Tool Access

This skill is limited to using the following tools:

ReadWriteMultiEditBashGrepGlobTodoWriteWebSearchWebFetchmcp__firecrawl-mcp__*
Supporting Assets
View in Repository
checklists/seo-geo-audit.md
reference/geo-methods.md
reference/platform-optimization.md
templates/meta-tags.md
templates/schema-faqpage.json
templates/schema-templates.md
Skill Content

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:

BotService
GooglebotGoogle
BingbotBing / Copilot
PerplexityBotPerplexity
ChatGPT-UserChatGPT with browsing
ClaudeBot / anthropic-aiClaude
GPTBotOpenAI

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):

MethodBoostPriority
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
Keyword Stuffing-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.

PlatformKey FactorCritical Action
ChatGPTDomain authorityUpdate content within 30 days
PerplexitySemantic relevanceFAQPage schema + PDF hosting
Google AI OverviewE-E-A-TAuthoritative citations (+132%)
Copilot / BingBing indexingPage speed < 2s
ClaudeBrave SearchHigh factual density

Common Mistakes

MistakeFix
Blocking AI bots in robots.txtAllow PerplexityBot, GPTBot, ClaudeBot explicitly
Keyword stuffingReduces visibility by 10%. Use natural language.
Missing FAQPage schemaAdds +40% AI visibility. Always include for FAQ content.
No statistics or citationsGEO research shows +37-40% boost from data and sources
Ignoring Brave SearchClaude uses Brave, not Google. Ensure Brave indexing.
Stale contentChatGPT cites 3.2x more from content updated within 30 days

Collaboration

  • Works with: content-strategist agent (strategy + keyword planning), creative-writing skill (content quality)
  • Complements: Content strategy with technical SEO implementation and GEO methodology
  • Outputs: Optimized markup, schema, audit reports, GEO-enhanced content

Supporting Documentation

Stats
Stars19
Forks2
Last CommitFeb 17, 2026
Actions

Similar Skills