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'.
Best use case
grey-haven-seo-geo-optimization is best used when you need a repeatable AI agent workflow instead of a one-off prompt.
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'.
Teams using grey-haven-seo-geo-optimization should expect a more consistent output, faster repeated execution, less prompt rewriting.
When to use this skill
- You want a reusable workflow that can be run more than once with consistent structure.
When not to use this skill
- You only need a quick one-off answer and do not need a reusable workflow.
- You cannot install or maintain the underlying files, dependencies, or repository context.
Installation
Claude Code / Cursor / Codex
Manual Installation
- Download SKILL.md from GitHub
- Place it in
.claude/skills/grey-haven-seo-geo-optimization/SKILL.mdinside your project - Restart your AI agent — it will auto-discover the skill
How grey-haven-seo-geo-optimization Compares
| Feature / Agent | grey-haven-seo-geo-optimization | Standard Approach |
|---|---|---|
| Platform Support | Not specified | Limited / Varies |
| Context Awareness | High | Baseline |
| Installation Complexity | Unknown | N/A |
Frequently Asked Questions
What does this skill do?
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'.
Where can I find the source code?
You can find the source code on GitHub using the link provided at the top of the page.
SKILL.md Source
# 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
```dot
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:**
```bash
# 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 | Google |
| 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](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 |
| ~~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](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](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
```bash
# 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](checklists/seo-geo-audit.md).
## Platform-Specific Quick Reference
Each AI search engine has different citation criteria. See [reference/platform-optimization.md](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-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
- **[reference/](reference/)** - Detailed optimization guides
- [geo-methods.md](reference/geo-methods.md) - Princeton GEO research (9 methods in depth)
- [platform-optimization.md](reference/platform-optimization.md) - Per-platform citation criteria
- **[checklists/](checklists/)** - Audit and validation
- [seo-geo-audit.md](checklists/seo-geo-audit.md) - Complete SEO/GEO audit checklist with report template
- **[templates/](templates/)** - Copy-paste ready markup
- [meta-tags.md](templates/meta-tags.md) - Meta tags, Open Graph, Twitter Cards
- [schema-faqpage.json](templates/schema-faqpage.json) - FAQPage JSON-LD template
- [schema-templates.md](templates/schema-templates.md) - All JSON-LD schema typesRelated Skills
generative-optimization
Expert guidance for solving optimization problems using generative models (GMM and Flow Matching). Use when users need to solve optimization, inverse problems, or find feasible solutions under constraints using probabilistic sampling approaches.
u09613-writing-and-rhetoric-optimization-for-household-logistics
Operate the "Writing And Rhetoric Optimization for household logistics" capability in production for household logistics workflows. Use when mission execution explicitly requires this capability and outcomes must be reproducible, policy-gated, and handoff-ready.
asset-optimization
Asset optimization skill for mesh and texture budgets.
sql-optimization-patterns
Master SQL query optimization, indexing strategies, and EXPLAIN analysis to dramatically improve database performance and eliminate slow queries. Use when debugging slow queries, designing database...
readability-optimization
Analyze and improve text readability using Flesch-Kincaid scores, sentence length, paragraph density, and plain language techniques. Use this skill when reviewing or editing existing text for clarity.
PostgreSQL Performance Optimization
Production-grade PostgreSQL query optimization, indexing strategies, performance tuning, and modern features including pgvector for AI/ML workloads. Master EXPLAIN plans, query analysis, and database design for high-performance applications
postgresql-optimization
PostgreSQL database optimization workflow for query tuning, indexing strategies, performance analysis, and production database management.
database-advanced-optimization
Use SQL (PostgreSQL) when:
Conversion Optimization
Conversion Rate Optimization (CRO) is the systematic process of increasing the percentage of website or app visitors who complete a desired action (conversion) through data-driven experimentation and
arch-performance-optimization
Use when analyzing and improving performance for database queries, API endpoints, or frontend rendering.
application-performance-performance-optimization
Optimize end-to-end application performance with profiling, observability, and backend/frontend tuning. Use when coordinating performance optimization across the stack.
api-response-optimization
Optimizes API performance through payload reduction, caching strategies, and compression techniques. Use when improving API response times, reducing bandwidth usage, or implementing efficient caching.