Agent skill

Aeo

by borghei in borghei/Claude-Skills

Answer Engine Optimization (AEO): optimize content to be cited by LLMs (ChatGPT, Claude, Perplexity, Gemini) in their answers.

MITAuto-check passedMarketing & SEO

Install Aeo

skills CLI
$ npx skills add borghei/Claude-Skills --skill aeo -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install borghei/Claude-Skills aeo --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/borghei/Claude-Skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/marketing/aeo .claude/skills/aeo && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
aeo
GitHub stars
874
Token cost
~3k tokens
SKILL.md length
1,308 words
Files
7 (incl. scripts, references)
Skills in repo
364
Repo updated
First seen
Licence
MIT

At a glance

Answer Engine Optimization (AEO): optimize content to be cited by LLMs (ChatGPT, Claude, Perplexity, Gemini) in their answers.

  • Works in 4 steps: Audit existing content: python3… → Add Q&A schema to high-value pages:… → Track citations from competitors:… → …
  • Designing content for LLM citation
  • SKILL.md covers When to use this skill, AEO vs SEO vs AI-SEO, The AEO funnel and The 5 content patterns that…, plus 8 more sections
  • Runs Python scripts from its folder; calls python3

What it does

Aeo is an agent skill from borghei/Claude-Skills. Answer Engine Optimization (AEO): optimize content to be cited by LLMs (ChatGPT, Claude, Perplexity, Gemini) in their answers. Use when designing content for LLM citation, auditing citability, or structuring Q&A schema.

Its SKILL.md is about 3k tokens, which your agent loads only when the skill is triggered. The skill folder holds 8 other files, including scripts and reference files (for example `references/aeo-fundamentals.md`, `references/citation-tracking-and-measurement.md` and `references/llm-content-structuring.md`).

It sits in Marketing & SEO, covering AI search optimization. It works with Perplexity and OpenAI. The repository describes itself as: 385 AI skills, 77 expert agents, and 900 stdlib Python tools for every team: engineering, PM, marketing, C-level, compliance, business ops, research, and a LinkedIn toolkit… The licence is MIT.

When your agent uses it

  • Designing content for LLM citation
  • Auditing citability
  • Structuring Q&A schema

Example prompts

  • “/aeo”

Requirements

  • Python 3

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  1. Audit existing content: python3 scripts/aeo_content_auditor.py --path ./content
  2. Add Q&A schema to high-value pages: python3 scripts/schema_qa_generator.py --content article.md
  3. Track citations from competitors: python3 scripts/citation_extractor.py --query "What is X?" --brand "Your Brand"
  4. Iterate: monthly content review with AEO scoring

What it can do on your machine

Read from SKILL.md and the folder at commit c9a1487. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 3 files in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python3

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Aeo loads about 3k tokens when it runs, and up to ~12k if it reads all its reference files. Until then it costs about 56 tokens; SKILL.md has 1,308 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~56
When it runs · the whole SKILL.md, loaded when a task matches
~3k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~12k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from borghei/Claude-Skills at commit c9a1487, republished under its MIT licence (© borghei). 1,308 words, ~3,043 tokens.

Download SKILL.mdSave it as .claude/skills/aeo/SKILL.md (or your agent's skills folder). This skill also uses 6 other files; get the full folder from GitHub.
name
aeo
description
Answer Engine Optimization (AEO): optimize content to be cited by LLMs (ChatGPT, Claude, Perplexity, Gemini) in their answers. Use when designing content for LLM citation, auditing citability, or structuring Q&A schema.
license
MIT + Commons Clause
metadata.version
1.0.0
metadata.author
borghei
metadata.category
marketing
metadata.domain
marketing
metadata.updated
2026-09-21
metadata.tags
aeo, answer-engine-optimization, llm-citation, generative-search, ai-content, schema-qa, geo, llm-seo

Answer Engine Optimization (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.


When to use this skill

SituationSkill applies
Designing content strategy that targets LLM citationYes — start with AEO fundamentals
Auditing existing content for LLM citabilityYes — scripts/aeo_content_auditor.py
Adding Q&A schema to contentYes — scripts/schema_qa_generator.py
Tracking which content gets cited by LLMsYes — scripts/citation_extractor.py
Choosing between AEO and traditional SEO investmentYes — see AEO vs SEO vs AI-SEO
Ranking in Perplexity / Google AI OverviewsUse marketing/ai-seo
Traditional SEO (rank in Google search results)Use marketing/seo-specialist

AEO vs SEO vs AI-SEO

Three distinct (but overlapping) practices. Confusing them leads to wasted investment.

PracticeOptimizes forSurfaceSuccess metric
Traditional SEOGoogle / Bing rankingsSERPs (organic blue links)Position, clicks
AI-SEOAI search enginesPerplexity, Google AI Overviews, You.comPosition in AI search results, traffic from citations
AEO (this skill)LLM citation in answersChatGPT, Claude, Gemini, Copilot answersCitation rate, brand mention in LLM outputs
Strategic positioning

For most B2B brands:

  • Traditional SEO: still 50-70% of organic traffic. Don't abandon.
  • AI-SEO: emerging 10-20% of search-driven engagement. Growing fast.
  • AEO: 5-15% of LLM-mediated user discovery. Largest growth potential.

Optimize content for all three simultaneously; the techniques substantially overlap.


The AEO funnel

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:

  • Citation is the new click. When LLM cites your content, you don't always get a visit — but you get attribution.
  • Brand-as-source becomes the goal. Even without click, being cited builds brand association.
  • Quality > volume. LLMs cite a small number of sources; quality of citation matters more than ranking position.
  • Trust signals matter more. LLMs avoid citing low-authority sources.

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.


The 5 content patterns that get cited

After analysis of LLM citation behavior, five content patterns dominate:

Pattern 1: Definitional content with clear claims

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].
Pattern 2: Comparative tables

LLMs use tables to extract comparisons. Markdown tables in published content (or HTML equivalents) get cited when users ask "X vs Y."

markdown
| Feature | Product A | Product B |
|---------|-----------|-----------|
| Price | $X | $Y |
| Speed | Z ms | W ms |
| Support | 24/7 | Business hours |
Pattern 3: Step-by-step procedural content

"How to [task]" content with explicit numbered steps. LLMs reproduce procedural steps; the cited source becomes the authoritative reference.

Pattern 4: Statistics + data with sources

LLMs cite content that provides numerical facts with attribution. "According to [your study], X% of [thing] does Y" is repeatable and citable.

Pattern 5: Lists with explanations

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


Clarify First

Before generating, confirm these inputs. If any is unknown or vague, ASK — do not assume:

  • Target queries — the actual questions customers ask LLMs about your category (drives which content to audit and restructure)
  • Your brand name — exact wording to track in answers vs competitors (drives citation extraction)
  • Target LLM surface — ChatGPT / Claude / Perplexity / Gemini (citation behavior and trust signals differ per provider)
  • Canonical page/content — the high-value page to be the authoritative source (drives schema generation + pattern restructuring)

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.

Quick start

  1. Audit existing content: python3 scripts/aeo_content_auditor.py --path ./content
  2. Add Q&A schema to high-value pages: python3 scripts/schema_qa_generator.py --content article.md
  3. Track citations from competitors: python3 scripts/citation_extractor.py --query "What is X?" --brand "Your Brand"
  4. Iterate: monthly content review with AEO scoring

End-to-end workflows

Workflow: AEO content strategy from scratch
  1. Identify target queries — what questions do potential customers ask LLMs about your category?
  2. Audit competitor citations — which brands get cited for those queries? scripts/citation_extractor.py
  3. Audit your existing content — score current content for AEO patterns: scripts/aeo_content_auditor.py
  4. Prioritize 10-20 high-value pages — those that should be the canonical source
  5. Restructure per AEO patterns — definitional content, tables, step-by-step, statistics
  6. Add structured data (optional) — scripts/schema_qa_generator.py generates FAQ schema; the visible Q&A structure matters more than the markup (Google retired FAQ rich results in May 2026 and says no special schema is needed for AI features)
  7. Build authority signals — backlinks, citations, mentions
  8. Monitor monthly — track citation rate trend
Show full SKILL.md (511 more words)Show less
Workflow: Audit individual content piece
  1. Run scripts/aeo_content_auditor.py --path article.md --format markdown
  2. Review per-pattern scoring (5 patterns above)
  3. Identify gaps: missing definition, no table, no clear steps, no stats, no list
  4. Restructure to add 2-3 missing patterns
  5. Optionally add FAQ schema with scripts/schema_qa_generator.py (no Google rich result; low impact)
  6. Re-audit to confirm improvements
Workflow: Competitive citation analysis
  1. Identify 10-20 key queries in your category
  2. Query each LLM (ChatGPT, Claude, Perplexity, Gemini) with those questions
  3. Record citations + brands mentioned
  4. Analyze: which brands dominate? what content do they have?
  5. Identify white-space queries (no clear dominant source yet)
  6. Prioritize content creation for white-space queries
Workflow: Measure AEO performance
  1. Citation rate: % of queries where your brand is cited (target: 30%+ for category leaders)
  2. Brand mention rate: % of queries where your brand is mentioned (cited or not)
  3. Source quality: are you cited as primary source or supporting?
  4. Click-through from citations: traffic attributable to LLM citations (requires source tracking)
  5. Voice tracking: how is your brand characterized (positive / neutral / negative attributes)

See references/citation-tracking-and-measurement.md for measurement methodologies, attribution challenges, and competitive benchmarking.


Common AEO failures

  • Optimizing only for Google SERP: misses the LLM citation surface entirely
  • Generic content without specific claims: LLMs prefer specific, factual content over generic explanation
  • No structure markers (headings, lists, tables): LLMs can't extract specific information
  • No visible Q&A structure: answers buried in prose instead of question headings with direct answers (the markup alone does not help — Google states no special schema is required for AI Overviews / AI Mode, as of September 2026)
  • Stuffed keyword content: LLMs prefer natural language with clear meaning
  • No authority signals: LLMs avoid citing low-trust sources
  • Outdated content: LLMs prefer recent, current content
  • Hidden behind paywalls: LLMs can't cite what they can't access
  • No structured data: missed opportunity for richer extraction
  • Brand-first content: LLMs prefer informational content over promotional

LLM-by-LLM citation behavior

Different LLMs have different citation behaviors:

LLMCitation styleWhat gets cited
ChatGPTInline citations (when web-enabled); fewer otherwiseRecent, authoritative sources
ClaudeCitations when grounding enabled (tools); generally avoids unsupported claimsHigh-quality sources, evidence-based
PerplexityAlways cites sources prominentlyRecent + authoritative sources
Google Gemini / AI OverviewsCites in AI Overviews + Gemini responsesHigh-ranking pages + structured data
Copilot (Microsoft)Cites sources prominentlySources varied
Meta AILighter citationLimited transparency

Optimize content with structure markers (headings, lists, tables) and authority signals (links, citations, expert attribution) — works across all of these.


Tooling

ScriptPurpose
scripts/aeo_content_auditor.pyScore content for AEO patterns (definition, table, steps, stats, list, structure markers)
scripts/citation_extractor.pyParse LLM responses (saved transcripts) for brand citations + competitive analysis
scripts/schema_qa_generator.pyGenerate JSON-LD FAQ schema from content (FAQPage / QAPage / HowTo)

References


  • marketing/ai-seo — AI search engine ranking (Perplexity, Google AI Overviews); complementary to AEO
  • marketing/seo-specialist — traditional SEO (Google rankings); foundational; still 50-70% of organic
  • marketing/seo-audit — technical SEO audit
  • marketing/programmatic-seo — scaled content production with SEO patterns
  • c-level-advisor/cs-cmo-advisor — strategic AEO investment decisions

© borghei, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 6 other files (scripts, references) in marketing/aeo of borghei/Claude-Skills.

  • SKILL.md
  • references/aeo-fundamentals.md
  • references/citation-tracking-and-measurement.md
  • references/llm-content-structuring.md
  • scripts/aeo_content_auditor.py
  • scripts/citation_extractor.py
  • scripts/schema_qa_generator.py

Open the folder on GitHubat commit c9a1487

Compare with similar skills

Aeo next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Aeo compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Aeo this skillborghei/Claude-Skills874—~3kAutomated safety check: PassMIT
Geo Fundamentalswasp-lang/wasp19k8 repos~861Automated safety check: PassMIT
SEO GeoReScienceLab/opc-skills1.8k4 repos~2.1kAutomated safety check: PassApache-2.0
GEO-First SEO Audit Toolzubair-trabzada/geo-seo-claude11k—~2.8kAutomated safety check: NotesMIT
Qiaomu SEOjoeseesun/qiaomu-seo439—~2.6kAutomated safety check: PassMIT
Fire Your SEO Agencyleopard627/fire-your-seo-agency706—~1.1kAutomated safety check: PassMIT

Similar skills

  • Geo Fundamentals

    wasp-lang/wasp

    Generative Engine Optimization for AI search engines (ChatGPT, Claude, Perplexity).

    19k GitHub starsUsed in 8 repos~861 tokens
    Marketing & SEOAuto-check passed
  • SEO Geo

    ReScienceLab/opc-skills

    SEO & GEO (Generative Engine Optimization) for websites. An agent skill from ReScienceLab/opc-skills.

    1.8k GitHub starsUsed in 4 repos~2.1k tokens
    Marketing & SEOAuto-check passed
  • GEO-First SEO Audit Tool

    zubair-trabzada/geo-seo-claude

    Audits a website for AI search visibility across ChatGPT, Claude, Perplexity and Google AI Overviews while checking traditional SEO, schema and E-E-A-T content quality.

    11k GitHub stars~2.8k tokensUpdated yesterday
    Marketing & SEOAuto-check: notes
  • Qiaomu SEO

    joeseesun/qiaomu-seo

    Audit, diagnose, research, plan, implement, experiment on, and verify website SEO across Google, Bing, and AI-search surfaces.

    439 GitHub stars~2.6k tokensUpdated 2 mo ago
    Marketing & SEOAuto-check passed
  • Fire Your SEO Agency

    leopard627/fire-your-seo-agency

    SEO·AEO·GEO·LLMO·NEO(네이버) 다섯 레인을 진단하고 직접 구현하며, 인용되는 콘텐츠를 계속 생산하는 서브 블로그·콘텐츠 운영 파이프라인까지 세팅하는 스킬.

    706 GitHub stars~1.1k tokensUpdated 12 days ago
    Marketing & SEOAuto-check passed
  • Marketing Os

    Yuzzyuk/marketing-os

    A complete marketing department in one skill. An agent skill from Yuzzyuk/marketing-os.

    535 GitHub stars~2.5k tokensUpdated 1 mo ago
    Marketing & SEOAuto-check passed

More from borghei/Claude-Skills

All 364 skills in this repo
  • Agents In The Team

    borghei/Claude-Skills

    Run delivery when AI coding and ops agents take tickets. An agent skill from borghei/Claude-Skills.

    874 GitHub stars~4.2k tokensUpdated today
    Auto-check passed
  • AI Content Disclosure

    borghei/Claude-Skills

    Check AI-generated marketing content and reviews for required disclosures under the EU AI Act, FTC rules and platform AI-label policies.

    874 GitHub stars~3.4k tokensUpdated today
    Auto-check passed
  • AI Prototyping

    borghei/Claude-Skills

    Idea to AI-generated prototype to customer validation to engineering handoff.

    874 GitHub stars~3.6k tokensUpdated today
    Auto-check passed
  • Analytics Engineer

    borghei/Claude-Skills

    Analytics engineering across data modeling, dbt, transformation, and semantic layers.

    874 GitHub stars~3.4k tokensUpdated today
    Auto-check passed
  • Ansoff Matrix

    borghei/Claude-Skills

    Ansoff Matrix — 4-quadrant framework for growth options: market penetration, market/product development, and diversification.

    874 GitHub stars~2.2k tokensUpdated today
    Auto-check passed
  • Brainstorm Okrs

    borghei/Claude-Skills

    OKR brainstorming and validation using the Radical Focus framework — outcome objectives, measurable key results, counter-metrics.

    874 GitHub stars~1.4k tokensUpdated today
    Auto-check passed

Categories

Questions about Aeo

What does Aeo do?

Answer Engine Optimization (AEO): optimize content to be cited by LLMs (ChatGPT, Claude, Perplexity, Gemini) in their answers. Aeo is an agent skill from borghei/Claude-Skills. Answer Engine Optimization (AEO): optimize content to be cited by LLMs (ChatGPT, Claude, Perplexity, Gemini) in their answers.

When should I use Aeo?

Aeo fits situations like: designing content for LLM citation; auditing citability; structuring Q&A schema.

How do I install Aeo in Claude Code?

Run `npx skills add borghei/Claude-Skills --skill aeo -a claude-code`. Or copy the skill folder (marketing/aeo in borghei/Claude-Skills) into .claude/skills/aeo in your project. Claude Code loads it when a task matches its description.

How do I install Aeo in Codex?

Run `npx skills add borghei/Claude-Skills --skill aeo -a codex`. Or copy the skill folder (marketing/aeo in borghei/Claude-Skills) into .agents/skills/aeo in your project. Codex loads it when a task matches its description.

Can I use Aeo in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add borghei/Claude-Skills --skill aeo -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/aeo, .gemini/skills/aeo, .github/skills/aeo and .opencode/skills/aeo in your project.

What does Aeo need to run?

Going by SKILL.md and its folder, Aeo needs Python for the scripts in its folder and the command-line tools its instructions call (python3). Our summary lists: Python 3.

Does Aeo access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Aeo safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Aeo use?

Aeo is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Aeo use?

About 3k tokens (SKILL.md is roughly 12k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 8.6k tokens, read only when the agent opens those files.

What are the alternatives to Aeo?

Skills that share tags, products or a category with Aeo: Geo Fundamentals (wasp-lang/wasp, 19k stars), SEO Geo (ReScienceLab/opc-skills, 1.8k stars), GEO-First SEO Audit Tool (zubair-trabzada/geo-seo-claude, 11k stars) and Qiaomu SEO (joeseesun/qiaomu-seo, 439 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Aeo?

borghei (a GitHub user) maintains it in borghei/Claude-Skills, which has 874 GitHub stars. The repository holds 364 skills in this directory. The repository was last updated on October 7, 2026.

Source: borghei/Claude-Skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.