SkillAgentSearch skills...

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 ChatG…

Install / Use

npx skills add coreyhaines31/marketingskills --skill ai-seo

Installs into whichever agent you are using.

About this skill
📄

SKILL.md

Installable skill definition

Quality Score

98/100

Supported Platforms

Claude Code
Gemini CLI

Tags

Our assessment of ai-seo

ai-seo scores 98/100 on our quality scale, 28th of 585 AI & Machine Learning skills we index (top 5%).

Its SKILL.md is 29 KB long, well organised into 40 sections with 2 code examples: a thorough specification that gives an agent plenty to work with.

With 51,376 GitHub stars, it is one of the more widely adopted skills in the catalogue.

Substance
30/30
Structure
18/20
Description
15/15
Adoption
20/20
Freshness
15/15

Maintenance, license and trust

  • The repository was last updated 20 days ago, so ai-seo is actively maintained.
  • It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
  • Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.

Safety scan

No issues found

Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands.

Automated pattern scan on 2026-09-25. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.

ai-seo compared with similar skills

All 4 of these similar skills score higher than ai-seo; compare them before choosing.

SkillScoreStarsUpdatedFormat
ai-seo (this skill)by coreyhaines319851.4k20d agoSKILL.md
claude-memby thedotmack10094.6ktodayCLAUDE.md
Understand-Anythingby Egonex-AI10084.1k13d agoCLAUDE.md
headroomby headroomlabs-ai10073.7ktodayCLAUDE.md
CowAgentby zhayujie10047.1ktodayCLAUDE.md

Frequently asked questions

How do I install ai-seo?
Run npx skills add coreyhaines31/marketingskills --skill ai-seo. The install tabs above show the steps for each supported agent.
Which AI agents does ai-seo work with?
It is written for Claude Code and Gemini CLI, as a SKILL.md file. Other agents that read the same format can often use it too.
Is ai-seo safe to use?
Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. It is MIT-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
Is ai-seo still maintained?
The repository was last updated 20 days ago, so ai-seo is actively maintained.

name: ai-seo description: "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,' 'optimize for Claude/Gemini,' 'llms.txt,' 'llms-full.txt,' 'OKF,' 'Open Knowledge Format,' 'knowledge bundle,' 'agent-readable site,' 'agent readiness,' 'is my site agent-ready,' 'WebMCP,' 'do listicles still work for AI,' 'ChatGPT stopped citing comparison pages,' or 'AI citation format shift.' 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." metadata: version: 2.5.0

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.

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

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

ChatGPT fans out too — and you can extract its literal background queries for your niche via DevTools (method in references/format-volatility.md). Post-5.6, ChatGPT's fan-outs shifted away from "best/vs/top" modifiers toward site: and "official" searches — use the extraction to see where your category's fan-outs stand today.


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 — Google Gemini and AI Overviews
  • Bingbot — Microsoft Copilot (via Bing)

Check your robots.txt for Disallow rules targeting any of these. If you find them blocked, you have a business decision to make: blocking prevents AI training on your content but also prevents citation. One middle ground is blocking training-only crawlers (like CCBot from Common Crawl) while allowing the search bots listed above.

See references/platform-ranking-factors.md for the full robots.txt configuration.


Optimization Strategy

The Three Pillars

1. Structure (make it extractable)
2. Authority (make it citable)
3. Presence (be where AI looks)

Pillar 1: Structure — Make Content Extractable

AI systems extract passages, not pages. Every key claim should work as a standalone statement.

Content block patterns:

  • Definition blocks for "What is X?" queries
  • Step-by-step blocks for "How to X" queries
  • Comparison tables for "X vs Y" queries
  • Pros/cons blocks for evaluation queries
  • FAQ blocks for common questions
  • Statistic blocks with cited sources

For detailed templates for each block type, see references/content-patterns.md.

Structural rules:

  • Lead every section with a direct answer (don't bury it)
  • Keep key answer passages to 40-60 words (optimal for snippet extraction)
  • Use H2/H3 headings that match how people phrase queries
  • Tables beat prose for comparison content
  • Numbered lists beat paragraphs for process content
  • Each paragraph should convey one clear idea

Pillar 2: Authority — Make Content Citable

AI systems prefer sources they can trust. Build citation-worthiness.

The Princeton GEO research (KDD 2024, studied across Perplexity.ai) ranked 9 optimization methods:

| Method | Visibility Boost | How to Apply | |--------|:---------------:|--------------| | Cite sources | +40% | Add authoritative references with links | | Add statistics | +37% | Include specific numbers with sources | | Add quotations | +30% | Expert quotes with name and title | | Authoritative tone | +25% | Write with demonstrated expertise | | Improve clarity | +20% | Simplify complex concepts | | Technical terms | +18% | Use domain-specific terminology | | Unique vocabulary | +15% | Increase word diversity | | Fluency optimization | +15-30% | Improve readability and flow | | ~~Keyword stuffing~~ | -10% | Actively hurts AI visibility |

Best combination: Fluency + Statistics = maximum boost. Low-ranking sites bene

Truncated for display — read the full file on GitHub.

Related Skills

View on GitHub
GitHub Stars51.4k
CategoryAI
Updated20d ago
Forks7.8k

Languages

JavaScript

Trust signals

100/100

From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.

No cautions