| name | seo-geo |
| description | SEO + Generative Engine Optimization (GEO) for 2026 — technical SEO, on-page optimization, structured data (JSON-LD, schema.org), Core Web Vitals, citability scoring (llms.txt, entity clarity), AI search engine optimization (ChatGPT, Gemini, Perplexity, Claude, Google AI Overviews), and brand authority building. Use when user asks to optimize a site for search engines, improve SEO, write SEO content, implement structured data, optimize for AI search/GEO, audit a page, or improve Google rankings. Do NOT use for content writing strategy (use content-marketing), performance optimization beyond Core Web Vitals (use performance-profiler), or paid ad strategy. |
| license | MIT |
| compatibility | opencode |
| metadata | {"workflow":"marketing","audience":"developers","version":"4.0","author":"shokunin"} |
| allowed-tools | Read Bash Write Grep WebFetch |
SEO & GEO Architect
Optimize for traditional search AND AI-powered engines. Based on Google Search Central, Moz, and GEO research (2025-2026).
Sub-Commands
| Command | Description |
|---|
audit-seo | Run full SEO audit (titles, meta, schema, speed, mobile) |
audit-geo | Run GEO audit (llms.txt, entity clarity, AI answer format) |
schema | Generate JSON-LD structured data for any page type |
optimize | Implement priority fixes ranked by impact |
llms | Generate/update llms.txt for AI crawler discovery |
Workflow
Step 1: Run SEO audit
Check: title tags (< 60 chars, keyword first), meta descriptions (< 155 chars, value prop), H1 (one per page, keyword), img alt text, OG tags, canonical, robots.txt, sitemap.xml, Core Web Vitals.
Score: 90-100% good. 70-89% fix flagged. < 70% structural issues first.
Step 2: Run GEO audit
Check: llms.txt presence, ai-plugin.json, FAQ/HowTo schema, entity clarity, brand mention structure, answer format (direct answer in first 2 paragraphs).
Step 3: Prioritized fixes
| Fix | Impact | Effort |
|---|
| Fix crawl errors (GSC) | High | Low |
| Improve LCP < 2.5s | High | Medium |
| Add structured data (JSON-LD) | High | Medium |
| Create llms.txt | High | Low |
| Fix meta titles/descriptions | Medium | Low |
| Add hreflang (if multilingual) | Medium | Low |
| Improve internal linking | Medium | Medium |
Step 4: Structured data (must implement)
{
"@context": "https://schema.org",
"@type": "Organization",
"name": "Brand Name",
"description": "One sentence. What you do.",
"url": "https://example.com",
"logo": "https://example.com/logo.png",
"sameAs": ["https://twitter.com/handle", "https://github.com/handle"]
}
Also: Article, FAQPage, HowTo, Product, BreadcrumbList, LocalBusiness (if applicable).
Step 5: llms.txt
# Brand Name
> One-line description.
## Core pages
- https://example.com/: Home
- https://example.com/about: About
## Docs
- https://docs.example.com/api: API reference
## Blog
- https://example.com/blog/post: Title
Place at /.well-known/llms.txt. This is how AI crawlers (GPTBot, Claude, Gemini) discover your site.
Step 6: GEO optimization
| Factor | Implementation |
|---|
| Citability | Publish original research, unique data. AI cites sources. |
| Entity clarity | Clear about pages. Define who/what/for whom. |
| Answer format | Direct answer in first 2 paragraphs before expanding. |
| Conversational tone | Write naturally. AI penalizes keyword stuffing. |
| Source authority | Link to .edu, .gov, peer-reviewed. Build topical authority. |
| Brand mentions | Get mentioned on authoritative sites. |
Production Checklist
Anti-Patterns
| Mistake | Fix |
|---|
| Keyword stuffing | Natural language. For humans first, search second. |
| No structured data | Schema critical for Google AND AI search. |
| No original research | AI cites original data. Publish unique findings. |
| Thin content (< 500 words) | Comprehensive, authoritative. |
| Ignoring Core Web Vitals | Performance is a ranking factor. |
| No E-E-A-T signals | Author bios, citations, credentials, about page. |
Sources
- Google Search Central
- Google E-E-A-T guidelines
- schema.org documentation
- Moz Beginner's Guide to SEO
- GEO research papers (2025-2026)
- Perplexity Publisher Guidelines
- OpenAI GPT crawler docs
