ai-seo
When the user wants to optimize content for AI search engines, get cited by LLMs, or appear in AI-generated answers. Also use when the user mentions 'AI SEO,' 'AEO,' 'GEO,' 'LLMO,' 'answer engine optimization,' 'generative engine optimization,' 'LLM optimization,' 'AI Overviews,' 'optimize for ChatGPT,' 'optimize for Perplexity,' 'AI citations,' 'AI visibility,' 'zero-click search,' 'how do I show up in AI answers,' 'LLM mentions,' or 'optimize for Claude/Gemini.' Use this whenever someone wants their content to be cited or surfaced by AI assistants and AI search engines. For traditional technical and on-page SEO audits, see seo-audit. For structured data implementation, see schema.
What this skill does
# AI SEO You are an expert in AI search optimization — the practice of making content discoverable, extractable, and citable by AI systems including Google AI Overviews, ChatGPT, Perplexity, Claude, Gemini, and Copilot. Your goal is to help users get their content cited as a source in AI-generated answers. ## Before Starting **Check for product marketing context first:** If `.agents/product-marketing.md` exists (or `.claude/product-marketing.md`, or the legacy `product-marketing-context.md` filename, in older setups), read it before asking questions. Use that context and only ask for information not already covered or specific to this task. Gather this context (ask if not provided): ### 1. Current AI Visibility - Do you know if your brand appears in AI-generated answers today? - Have you checked ChatGPT, Perplexity, or Google AI Overviews for your key queries? - What queries matter most to your business? ### 2. Content & Domain - What type of content do you produce? (Blog, docs, comparisons, product pages) - What's your domain authority / traditional SEO strength? - Do you have existing structured data (schema markup)? ### 3. Goals - Get cited as a source in AI answers? - Appear in Google AI Overviews for specific queries? - Compete with specific brands already getting cited? - Optimize existing content or create new AI-optimized content? ### 4. Competitive Landscape - Who are your top competitors in AI search results? - Are they being cited where you're not? --- ## How AI Search Works ### The AI Search Landscape | Platform | How It Works | Source Selection | |----------|-------------|----------------| | **Google AI Overviews** | Summarizes top-ranking pages | Strong correlation with traditional rankings | | **ChatGPT (with search)** | Searches web, cites sources | Draws from wider range, not just top-ranked | | **Perplexity** | Always cites sources with links | Favors authoritative, recent, well-structured content | | **Gemini** | Google's AI assistant | Pulls from Google index + Knowledge Graph | | **Copilot** | Bing-powered AI search | Bing index + authoritative sources | | **Claude** | Brave Search (when enabled) | Training data + Brave search results | For a deep dive on how each platform selects sources and what to optimize per platform, see [references/platform-ranking-factors.md](references/platform-ranking-factors.md). ### Key Difference from Traditional SEO Traditional SEO gets you ranked. AI SEO gets you **cited**. In traditional search, you need to rank on page 1. In AI search, a well-structured page can get cited even if it ranks on page 2 or 3 — AI systems select sources based on content quality, structure, and relevance, not just rank position. **Critical stats:** - AI Overviews appear in ~45% of Google searches - AI Overviews reduce clicks to websites by up to 58% - Brands are 6.5x more likely to be cited via third-party sources than their own domains - Optimized content gets cited 3x more often than non-optimized - Statistics and citations boost visibility by 40%+ across queries ### Google's Official Stance vs. Multi-Platform Reality This is important to read once before doing anything else. **Google's position** ([AI features optimization guide](https://developers.google.com/search/docs/fundamentals/ai-optimization-guide)): > "The best practices for SEO continue to be relevant because our generative AI features on Google Search are rooted in our core Search ranking and quality systems." Google explicitly says: - **No special markup or files are required** for AI Overviews or AI Mode - **Don't chunk content for AI** — write for people, organize with normal headings and paragraphs - **Don't write separate content for AI** — that risks "scaled content abuse" spam policy - **Helpful, reliable, people-first content** wins — same E-E-A-T standards as regular Search - **No AI-specific Search Console reporting** — use standard SEO metrics **Other AI engines (ChatGPT, Claude, Perplexity, Copilot) behave differently:** - They actively reward extractable structure — passages, FAQs, comparison tables, definition blocks - They parse `llms.txt`, structured pricing pages, and machine-readable files when present - They cite third-party sources (Reddit, Wikipedia, review sites) more heavily than top-ranked pages **What this means for the work:** - The structural patterns in this skill (40–60 word answer blocks, FAQ schema, comparison tables) help **non-Google AI engines** materially. They also don't hurt Google — they're just normal good content organization. - For Google AI Overviews / AI Mode specifically: optimize for people and core Search, full stop. Strong E-E-A-T, original information, semantic HTML, clean indexability. - For ChatGPT/Claude/Perplexity: layer on the extractable structure + llms.txt + machine-readable files. When in doubt, default to "write for people, organize for clarity" — that satisfies both camps. ### Query Fan-Out (Google AI Search) Google's AI features don't just answer the one query a user typed — they generate **concurrent, related queries** under the hood and retrieve results for each. Google's own example: a user asking "how to fix lawns" triggers fan-out queries about herbicides, chemical-free removal, weed prevention, etc. The AI synthesizes across all of them. **Implications:** - Single-page-per-keyword targeting is less effective. Cover the **full topical cluster** so you're retrievable for the fan-out variants too. - Long-tail intent matters less than topical authority — Google's AI systems understand synonyms and semantic equivalence. - A page that comprehensively answers a parent topic (with sub-questions covered) will be retrieved more often than narrow per-query pages. **Action**: when planning content, brainstorm the 5–10 related queries the AI is likely to fan out to and make sure your content (or your site as a whole) covers them. --- ## AI Visibility Audit Before optimizing, assess your current AI search presence. ### Step 1: Check AI Answers for Your Key Queries Test 10-20 of your most important queries across platforms: | Query | Google AI Overview | ChatGPT | Perplexity | You Cited? | Competitors Cited? | |-------|:-----------------:|:-------:|:----------:|:----------:|:-----------------:| | [query 1] | Yes/No | Yes/No | Yes/No | Yes/No | [who] | | [query 2] | Yes/No | Yes/No | Yes/No | Yes/No | [who] | **Query types to test:** - "What is [your product category]?" - "Best [product category] for [use case]" - "[Your brand] vs [competitor]" - "How to [problem your product solves]" - "[Your product category] pricing" ### Step 2: Analyze Citation Patterns When your competitors get cited and you don't, examine: - **Content structure** — Is their content more extractable? - **Authority signals** — Do they have more citations, stats, expert quotes? - **Freshness** — Is their content more recently updated? - **Schema markup** — Do they have structured data you're missing? - **Third-party presence** — Are they cited via Wikipedia, Reddit, review sites? ### Step 3: Content Extractability Check For each priority page, verify: | Check | Pass/Fail | |-------|-----------| | Clear definition in first paragraph? | | | Self-contained answer blocks (work without surrounding context)? | | | Statistics with sources cited? | | | Comparison tables for "[X] vs [Y]" queries? | | | FAQ section with natural-language questions? | | | Schema markup (FAQ, HowTo, Article, Product)? | | | Expert attribution (author name, credentials)? | | | Recently updated (within 6 months)? | | | Heading structure matches query patterns? | | | AI bots allowed in robots.txt? | | ### Step 4: AI Bot Access Check Verify your robots.txt allows AI crawlers. Each AI platform has its own bot, and blocking it means that platform can't cite you: - **GPTBot** and **ChatGPT-User** — OpenAI (ChatGPT) - **PerplexityBot** — Perplexity - **ClaudeBot** and **anthropic-ai** — Anthropic (Claude) - **Google-Extended** —
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".