borghei/aeo
> (ChatGPT, Claude, Perplexity, Gemini) in their answers. Use when designing content for LLM citation, auditing citability, or structuring Q&A schema.
npx skills add https://github.com/borghei/Claude-Skills --skill aeo
End-to-end practice of optimizing content to be cited by LLMs when they generate answers. Covers the technical foundations (how LLMs select sources), content structuring patterns (Q&A schema, citation-worthy patterns), measurement (which content gets cited, by which LLM, how often), and the strategic positioning that differentiates AEO from traditional SEO and from AI-SEO.
This skill is provider-aware but provider-agnostic: works for content optimized for ChatGPT, Claude, Perplexity, Gemini, Copilot, and emerging AI surfaces.
| Situation | Skill applies |
|-----------|---------------|
| Designing content strategy that targets LLM citation | Yes — start with AEO fundamentals |
| Auditing existing content for LLM citability | Yes — scripts/aeo_content_auditor.py |
| Adding Q&A schema to content | Yes — scripts/schema_qa_generator.py |
| Tracking which content gets cited by LLMs | Yes — scripts/citation_extractor.py |
| Choosing between AEO and traditional SEO investment | Yes — see AEO vs SEO vs AI-SEO |
| Ranking in Perplexity / Google AI Overviews | Use marketing/ai-seo |
| Traditional SEO (rank in Google search results) | Use marketing/seo-specialist |
Three distinct (but overlapping) practices. Confusing them leads to wasted investment.
| Practice | Optimizes for | Surface | Success metric |
|----------|---------------|---------|----------------|
| Traditional SEO | Google / Bing rankings | SERPs (organic blue links) | Position, clicks |
| AI-SEO | AI search engines | Perplexity, Google AI Overviews, You.com | Position in AI search results, traffic from citations |
| AEO (this skill) | LLM citation in answers | ChatGPT, Claude, Gemini, Copilot answers | Citation rate, brand mention in LLM outputs |
For most B2B brands:
Optimize content for all three simultaneously; the techniques substantially overlap.
Users find brands through LLMs in a different funnel than search:
Traditional search: AEO funnel:
1. User types query 1. User asks LLM a question
2. SERPs show ~10 results 2. LLM generates answer
3. User clicks one 3. LLM cites N sources (1-10)
4. User reads page 4. User reads answer; may click cited source
5. User converts 5. User attributes answer to LLM (less so to cited brand)
Key implications:
See references/aeo-fundamentals.md for the deep mechanics of how LLMs select sources, the citation models per provider, and the trust signals that drive selection.
After analysis of LLM citation behavior, five content patterns dominate:
LLMs cite sources for definitions, facts, and short claims. Pages that answer "What is X?" with a clean 2-3 sentence definition followed by elaboration get cited often.
Structure:
[Term] is [crisp definition in 1-2 sentences].
[Elaboration with context and nuance — 1-3 paragraphs].
[Related concepts / scope / boundaries — optional].
LLMs use tables to extract comparisons. Markdown tables in published content (or HTML equivalents) get cited when users ask "X vs Y."
| Feature | Product A | Product B |
|---------|-----------|-----------|
| Price | $X | $Y |
| Speed | Z ms | W ms |
| Support | 24/7 | Business hours |
"How to [task]" content with explicit numbered steps. LLMs reproduce procedural steps; the cited source becomes the authoritative reference.
LLMs cite content that provides numerical facts with attribution. "According to [your study], X% of [thing] does Y" is repeatable and citable.
"Top N approaches to X" with each item explained gets cited when users ask comparative or enumeration questions.
See references/llm-content-structuring.md for deep patterns including FAQ schema, citation hooks, voice-search optimization, and LLM-readable structure markers.
Before generating, confirm these inputs. If any is unknown or vague, ASK — do not assume:
Stop rule: ask only the 2-3 that most change the output. If the user says "just draft it," proceed and list your assumptions at the top of the artifact.
python3 scripts/aeo_content_auditor.py --path ./contentpython3 scripts/schema_qa_generator.py --content article.mdpython3 scripts/citation_extractor.py --query "What is X?" --brand "Your Brand"scripts/citation_extractor.pyscripts/aeo_content_auditor.pyscripts/schema_qa_generator.py generates FAQ schemascripts/aeo_content_auditor.py --path article.md --format markdownscripts/schema_qa_generator.pySee references/citation-tracking-and-measurement.md for measurement methodologies, attribution challenges, and competitive benchmarking.
Different LLMs have different citation behaviors:
| LLM | Citation style | What gets cited |
|-----|----------------|-----------------|
| ChatGPT | Inline citations (when web-enabled); fewer otherwise | Recent, authoritative sources |
| Claude | Citations when grounding enabled (tools); generally avoids unsupported claims | High-quality sources, evidence-based |
| Perplexity | Always cites sources prominently | Recent + authoritative sources |
| Google Gemini / AI Overviews | Cites in AI Overviews + Gemini responses | High-ranking pages + structured data |
| Copilot (Microsoft) | Cites sources prominently | Sources varied |
| Meta AI | Lighter citation | Limited transparency |
Optimize content with structure markers (headings, lists, tables) and authority signals (links, citations, expert attribution) — works across all of these.
| Script | Purpose |
|--------|---------|
| scripts/aeo_content_auditor.py | Score content for AEO patterns (definition, table, steps, stats, list, structure markers) |
| scripts/citation_extractor.py | Parse LLM responses (saved transcripts) for brand citations + competitive analysis |
| scripts/schema_qa_generator.py | Generate JSON-LD FAQ schema from content (FAQPage / QAPage / HowTo) |
marketing/ai-seo — AI search engine ranking (Perplexity, Google AI Overviews); complementary to AEOmarketing/seo-specialist — traditional SEO (Google rankings); foundational; still 50-70% of organicmarketing/seo-audit — technical SEO auditmarketing/programmatic-seo — scaled content production with SEO patternsc-level-advisor/cs-cmo-advisor — strategic AEO investment decisionsTake borghei/aeo from the repository into ~/.claude/skills for personal
use, or into .claude/skills inside a project.
The agent identifies a skill by the name field in its header. Two skills with the
same name cannot sit side by side — one of them will be ignored.