seo-geo
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'.
What this skill does
# 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 types
Related in Ads & Marketing
ads
IncludedMulti-platform paid advertising audit and optimization skill. Analyzes Google, Meta, YouTube, LinkedIn, TikTok, Microsoft, and Apple Ads. 250+ checks with scoring, parallel agents, industry templates, and AI creative generation.
banana
IncludedAI image generation Creative Director powered by Google Gemini Nano Banana models. Use this skill for ANY request involving image creation, editing, visual asset production, or creative direction. Triggers on: generate an image, create a photo, edit this picture, design a logo, make a banner, visual for my anything, and all /banana commands. Handles text-to-image, image editing, multi-turn creative sessions, batch workflows, and brand presets.
rpg-migration-analyzer
IncludedAnalyzes legacy RPG (Report Program Generator) programs from AS/400 and IBM i systems for migration to modern Java applications. Extracts business logic from RPG III/IV/ILE source code, identifies data structures (D-specs), file operations (F-specs), program dependencies (CALLB/CALLP), and converts RPG constructs to Java equivalents. Generates migration reports, complexity estimates, and Java implementation strategies with POJO classes, JPA entities, and service methods. Use when modernizing AS/400 or IBM i legacy systems, analyzing RPG source files (.rpg, .rpgle, .RPGLE), converting RPG to Java, mapping data specifications to Java classes, planning legacy system migration, or when user mentions RPG analysis, Report Program Generator, RPG III/IV/ILE, AS/400 modernization, IBM i migration, packed decimal conversion, or mainframe application rewrite.
brand-library-architect
IncludedBuild a complete brand library for a product — visual asset render pipeline, brand documentation set (BRAND, COPY, MANIFESTO, BIOS, FAQ, GLOSSARY, TONE, PRICING), open-source convention files (README, CONTRIBUTING, SECURITY, CODE_OF_CONDUCT), and a self-contained press kit. This skill should be used when the user asks to "build a brand library / brand kit / press kit / brand assets" for a product, "set up a brand library workflow," "create a positioning manifesto plus visual identity," or any combination of brand documentation + visual asset pipeline. Apply phase-by-phase or run end-to-end. Templates are product-agnostic and use {{TOKEN}} placeholders the skill prompts the user to fill.
writing-tech-post
IncludedAuthors engineering blog posts end-to-end: launch deep-dives, incident postmortems, architecture migrations, performance case studies, tutorials, AI/agent system writeups, security disclosures, and research-to-product translations. Picks the correct archetype, plans the abstraction ladder, enforces an evidence cadence (diagrams, benchmarks, profiles, traces, code, ablations), tunes voice against publisher house styles (Datadog, Vercel, GitHub, AWS, Meta, Cloudflare, Jane Street), and runs a pre-publish gate for narrative momentum and disclosure ethics. Use when drafting a new engineering post, restructuring a draft that feels flat, deciding which evidence form belongs where, validating that depth and product context are balanced, or preparing a postmortem, migration, or performance narrative for external publication. Do not use for API reference documentation, README authoring, marketing copy, release notes, generic SEO content, ghost-written executive thought leadership, or non-engineering long-form essays.
blog-google
IncludedGoogle API integration for blog performance: PageSpeed Insights, CrUX Core Web Vitals with 25-week history, Search Console performance, URL Inspection, Indexing API, GA4 organic traffic, NLP entity analysis for E-E-A-T, YouTube video search for embedding, and Google Ads Keyword Planner. Progressive feature availability based on credential tier (API key, OAuth/service account, GA4, Ads). Shares config with claude-seo at ~/.config/claude-seo/google-api.json. Use when user says "google data", "page speed", "core web vitals", "search console", "indexation", "GA4", "keyword research", "nlp entities", "blog performance", "youtube search", "google api setup".