Answer Engine Optimization (AEO) skill — optimize content to be cited by AI language models (ChatGPT, Perplexity, Claude, Gemini, Mistral) as authoritative sources.

MITAuto-check passedMarketing & SEO

Install Aeo

skills CLI
$ npx skills add alirezarezvani/claude-skills --skill aeo -a claude-code

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

GitHub CLI
$ gh skill install alirezarezvani/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/alirezarezvani/claude-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/marketing-skill/skills/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
28k
Token cost
~2.7k tokens
SKILL.md length
946 words
Files
11 (incl. scripts, references)
Skills in repo
342
Repo updated
First seen
Licence
MIT

At a glance

Answer Engine Optimization (AEO) skill — optimize content to be cited by AI language models (ChatGPT, Perplexity, Claude, Gemini, Mistral) as authoritative sources.

  • Works in 3 steps: Content audit + E-E-A-T scoring → Content optimization → Citation tracking
  • Planning content for AI-first search audiences
  • SKILL.md covers Distinct From SEO, When To Use, When NOT To Use and Core Capabilities, plus 10 more sections
  • Runs Python scripts from its folder; calls python3 and pip

What it does

Aeo is an agent skill from alirezarezvani/claude-skills. Answer Engine Optimization (AEO) skill — optimize content to be cited by AI language models (ChatGPT, Perplexity, Claude, Gemini, Mistral) as authoritative sources. Distinct from SEO — AEO optimizes for citation in LLM-generated responses, not search rankings. Use when planning content for AI-first search audiences, auditing existing content for E-E-A-T signals, tracking which pages get cited by which LLMs, or building a citation-friendly content strategy. Triggers — 'AEO audit', 'optimize for ChatGPT', 'get…

Its SKILL.md is about 2.7k tokens, which your agent loads only when the skill is triggered. The skill folder holds 13 other files, including scripts and reference files (for example `.claude-plugin/authoring-notes.json`, `.claude-plugin/plugin.json` and `references/aeo_eeat_canon.md`).

It sits in Marketing & SEO, covering AI search optimization and Citation management. It works with Perplexity, OpenAI, Mistral AI and Python. The repository describes itself as: 380 Claude Code skills & agent skills & plugins (30+ Agents, 70+ custom commands, 380+ skills, customizable references, scripts)for Claude Code, Codex, Gemini CLI, Cursor, and 8… The licence is MIT.

When your agent uses it

  • Planning content for AI-first search audiences
  • Auditing existing content for E-E-A-T signals
  • Tracking which pages get cited by which LLMs
  • Building a citation-friendly content strategy

Example prompts

  • “AEO audit”
  • “optimize for ChatGPT”
  • “get cited by Perplexity”
  • “/aeo”

Requirements

  • Python 3

Workflow steps

3 steps, taken from the step headings in SKILL.md.

  1. Content audit + E-E-A-T scoring
  2. Content optimization
  3. Citation tracking

What it can do on your machine

Read from SKILL.md and the folder at commit 19392f7. 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
    • pip

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

  • Network

    Links to these hosts (documentation or services it may open):

    • github.com

    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 2.7k tokens when it runs, and up to ~14k if it reads all its reference files. Until then it costs about 185 tokens; SKILL.md has 946 words of instructions outside code blocks.

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

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 alirezarezvani/claude-skills at commit 19392f7, republished under its MIT licence (© alirezarezvani). 946 words, ~2,741 tokens.

Download SKILL.mdSave it as .claude/skills/aeo/SKILL.md (or your agent's skills folder). This skill also uses 10 other files; get the full folder from GitHub.
name
aeo
description
Answer Engine Optimization (AEO) skill — optimize content to be cited by AI language models (ChatGPT, Perplexity, Claude, Gemini, Mistral) as authoritative sources. Distinct from SEO — AEO optimizes for citation in LLM-generated responses, not search rankings. Use when planning content for AI-first search audiences, auditing existing content for E-E-A-T signals, tracking which pages get cited by which LLMs, or building a citation-friendly content strategy. Triggers — 'AEO audit', 'optimize for ChatGPT', 'get cited by Perplexity', 'LLM citation strategy', 'answer engine optimization', 'content for AI search', 'E-E-A-T audit'. Output is a markdown audit report (default) or JSON for pipeline integration. Stdlib-only Python tools.

Answer Engine Optimization (AEO)

Get your content cited by ChatGPT, Perplexity, Claude, Gemini, and Mistral as the authoritative source.

AEO is the practice of optimizing content for citation in LLM-generated responses — distinct from SEO, which optimizes for search rankings. This skill audits, optimizes, and tracks AEO performance.

Distinct From SEO

SEOAEO
Optimizes forClick-through rankingsBeing cited as authoritative source
AudienceHumans browsing search resultsLLMs answering questions
Success metricPosition 1-10, organic trafficCitation count across LLMs
Key signalsBacklinks, keywords, page speedE-E-A-T, structured data, factual density
Update cadenceWeeks-to-monthsDays-to-weeks (LLM training cycles)

Both can coexist — the same content can rank #1 on Google AND get cited by Perplexity. But the techniques differ: SEO rewards keyword density + backlinks; AEO rewards primary-source signals + structured facts.

When To Use

  • Planning a new content piece for an AI-first audience
  • Auditing existing content for E-E-A-T gaps before AI Overview rollout
  • Tracking which pages get cited by which LLM (citation ledger)
  • Researching what queries LLMs cite sources for (vs. what they answer from training)
  • Benchmarking against competitors' citation rates
  • Building a long-term AEO strategy aligned with traditional SEO

When NOT To Use

  • Pure click-through SEO without LLM-citation intent — use marketing-skill/skills/seo-audit instead
  • Brand-voice content with no factual claims — citations require facts to cite
  • Content for a topic where LLMs already have strong training signal (e.g., elementary math) — citation upside is minimal
  • Time-sensitive content (breaking news) — LLM training lag means citations come months later

Core Capabilities

1. Content audit + E-E-A-T scoring

The auditor (aeo_audit.py) scores content across 4 dimensions:

  • Experience: First-person evidence, dated examples, case studies, "We ran X in 2026" claims
  • Expertise: Author bio, credentials, citations to peer-reviewed sources, technical depth
  • Authoritativeness: External backlinks from authority domains, schema.org markup, structured data
  • Trustworthiness: HTTPS, contact info, transparent corrections, factual density (number of verifiable claims per 1000 words)

Composite score 0-100 with per-dimension breakdown. Output: markdown report with specific fix recommendations.

2. Content optimization

The optimizer (aeo_optimizer.py) generates AEO-improved variants:

  • Structure rewrite — H2/H3 hierarchy optimized for LLM parsing
  • Citation density boost — adds [1]-style references with sources
  • Schema injection — generates JSON-LD for FAQ, HowTo, Article schemas
  • Fact-first lede — moves verifiable claims into the first 200 words

Three modes: conservative (touch <10% of words), balanced (touch <30%), aggressive (rewrite for maximum AEO).

3. Citation tracking

The tracker (citation_tracker.py) maintains a local ledger of citations:

  • Manual entry: paste a citation found in ChatGPT/Perplexity/Claude/Gemini output
  • Track which URL, which LLM, which query, what date
  • Compute per-page citation count, citation velocity, LLM coverage
  • Export to CSV for reporting

Stores in ~/.aeo-data/citations.json (local, no telemetry).

References

  • references/aeo_eeat_canon.md — E-E-A-T methodology, industry thresholds, anti-patterns
  • references/llm_citation_patterns.md — per-LLM citation selection heuristics (Perplexity, ChatGPT, Claude, Gemini, Mistral)
  • references/aeo_vs_seo.md — when to invest in AEO vs SEO vs both
  • references/bot_access_and_monitoring.md — AI crawler robots.txt matrix (the prerequisite check: a blocked bot zeroes that platform), Google Search Console AI Overviews monitoring, manual testing protocols, citation-drop diagnostic (merged from the former ai-seo skill)
  • references/extractable_content_patterns.md — 7 copy-ready block templates (definition, steps, table, FAQ, attributed stat, expert quote, summary box) that answer engines reliably extract (merged from the former ai-seo skill)

Workflow

0. Pre-flight: bot access
   Check robots.txt against the crawler matrix in references/bot_access_and_monitoring.md
   → a blocked GPTBot/PerplexityBot/ClaudeBot/Google-Extended is the first fix, always

1. Audit existing content
   $ python3 scripts/aeo_audit.py --url https://example.com/blog/post
   → markdown report with composite score + 4-dimension breakdown

2. Apply optimization recommendations
   $ python3 scripts/aeo_optimizer.py --input post.md --mode balanced --output post-aeo.md
   → optimized variant with citations + schema + structural fixes

3. Publish + monitor
   $ python3 scripts/citation_tracker.py --action add --url https://example.com/blog/post \
       --llm perplexity --query "what is AEO" --date 2026-05-17
   → adds entry to local citations.json ledger

4. Report
   $ python3 scripts/citation_tracker.py --action report --url https://example.com/blog/post
   → per-page citation stats: count, LLMs, queries, velocity

Configuration

The skill is industry-aware via per-run --industry flag. Supported: saas, healthcare, finance, legal, ecommerce, b2b, media, education.

Industry affects:

  • Authority signal requirements — healthcare/finance need stricter source citations
  • Fact-checking rigor — legal/healthcare flag unverifiable claims as critical
  • Citation style — academic vs. trade-journal vs. blog conventions

Example:

bash
python3 scripts/aeo_audit.py --url <url> --industry healthcare
# → stricter E-E-A-T thresholds; flags any health claim without primary citation

Output Format

Markdown audit report (default)
markdown
# AEO Audit Report — [Page Title]

**URL:** https://example.com/blog/post
**Date:** 2026-05-17
**Industry:** saas
**Composite Score:** 72/100 (B+)

## Dimension Breakdown

| Dimension | Score | Verdict |
|---|---|---|
| Experience | 80/100 | Strong — first-person case study present |
| Expertise | 65/100 | Author bio missing credentials |
| Authoritativeness | 75/100 | 4 backlinks from authority domains |
| Trustworthiness | 68/100 | No corrections policy linked |

## Top 3 Fixes

1. Add author bio with credentials (Expertise +15)
2. Link to corrections policy from footer (Trustworthiness +12)
3. Inject FAQ schema for the 5 questions implicit in H2s (Authoritativeness +8)

## All Recommendations
[...]

## Audit Trail
[3-count of analysis steps, sources cited, time taken]
JSON for pipelines
bash
python3 scripts/aeo_audit.py --url <url> --output json

Returns full structured data for integration with content management workflows.

Show full SKILL.md (372 more words)Show less

Industry-Specific E-E-A-T Thresholds

IndustryMin CompositeCritical Signals
Healthcare85Medical reviewer byline, peer-reviewed citations, FDA disclosure
Finance85Author CFA/CPA credentials, "not investment advice" disclaimer, dated examples
Legal85Jurisdiction disclosed, attorney bio, "not legal advice" disclaimer
SaaS70Product manager byline, case study with metrics, ROI calculator
E-commerce65Product reviews aggregated, return policy, schema.org Product
B2B70Industry analyst quotes, customer logos, ROI data
Media70Editorial policy, fact-check link, original reporting
Education75Instructor bio, learning outcomes, accreditation if applicable

Anti-Patterns Rejected

  • Keyword stuffing for AI — LLMs already extract topic from semantics; keyword density doesn't boost citation likelihood
  • Pure AI-generated content with no human review — generic LLM output gets de-prioritized by RAG retrieval algorithms looking for distinctive signal
  • Citation farms / link wheels — modern LLM RAG penalizes low-authority linked networks
  • Schema spam — false or unverifiable schema.org claims get filtered; only mark up real, verifiable claims
  • Optimizing for one LLM at expense of others — citation distributions are highly correlated across major LLMs because they share training data sources; optimize for the shared signals (E-E-A-T) not per-LLM hacks
  • Ignoring SEO entirely — AEO citations often originate from sources that already rank well organically; AEO and SEO are complements, not substitutes

Dependencies

  • stdlib-only for all 3 scripts — no pip install required
  • Optional: requests + beautifulsoup4 if --url mode used (otherwise pass markdown via --input for file-based audits)
  • Optional: any LLM API key for query_research mode (currently scaffold-only — full LLM-driven query research is roadmap)

Storage

All data is local-first:

  • ~/.aeo-data/citations.json — citation ledger
  • ~/.aeo-data/patterns.json — success patterns library
  • ~/.aeo-data/audits/<hash>.md — saved audit reports

No telemetry. No cloud sync. Export to CSV anytime via citation_tracker.py --action export.

Trigger Phrases

  • "AEO audit", "AEO check"
  • "optimize for ChatGPT / Perplexity / Claude / Gemini"
  • "get cited by [LLM]"
  • "LLM citation strategy"
  • "answer engine optimization"
  • "content for AI search"
  • "E-E-A-T audit"
  • "track AI citations"
  • "schema for AI"
  • marketing-skill/skills/seo-audit — traditional click-through SEO
  • marketing-skill/skills/programmatic-seo — template-driven SEO at scale
  • marketing-skill/skills/content-strategy — broader content planning
  • marketing-skill/skills/copywriting — voice + tone
  • marketing-skill/skills/schema-markup — structured data implementation

Version: 2.7.3 Source: Ported from alirezarezvani/aeo-box (answer-engine-optimization/ skill, 2,464 LOC across 9 modules). This port distills the 9-module Python toolkit into 3 stdlib CLI tools per the claude-skills convention; preserves the E-E-A-T scoring methodology, citation-tracking schema, and industry-aware thresholds verbatim. License: MIT (matches upstream + this repo).

© alirezarezvani, 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 10 other files (scripts, references) in marketing-skill/skills/aeo of alirezarezvani/claude-skills.

  • SKILL.md
  • .claude-plugin/authoring-notes.json
  • .claude-plugin/plugin.json
  • references/aeo_eeat_canon.md
  • references/aeo_vs_seo.md
  • references/bot_access_and_monitoring.md
  • references/extractable_content_patterns.md
  • references/llm_citation_patterns.md
  • scripts/aeo_audit.py
  • scripts/aeo_optimizer.py
  • scripts/citation_tracker.py

Open the folder on GitHubat commit 19392f7

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 skillalirezarezvani/claude-skills28k—~2.7kAutomated safety check: PassMIT
Ansvisor Aeo Coach Standaloneansvisor/ansvisor129—~3kAutomated safety check: PassMIT
SEO Auditshadcn-labs/agentcn486—~598Automated safety check: PassMIT
SEO ProfoundAgriciDaniel/claude-seo18k1 repos~441Automated safety check: PassMIT
AI Search Visibility Auditdavepoon/buildwithclaude3.6k—~2.4kAutomated safety check: PassMIT
Geo Fundamentalswasp-lang/wasp19k9 repos~861Automated safety check: PassMIT

Similar skills

  • Standalone (no-MCP) version of the Ansvisor AEO Coach. An agent skill from ansvisor/ansvisor.

    129 GitHub stars~3k tokensUpdated yesterday
    Marketing & SEOAuto-check passed
  • SEO Audit

    shadcn-labs/agentcn

    How to present the deterministic AI-SEO audit returned by auditpage.

    486 GitHub stars~598 tokensUpdated yesterday
    Marketing & SEOAuto-check passed
  • SEO Profound

    AgriciDaniel/claude-seo

    Profound LLM citation tracker (extension). An agent skill from AgriciDaniel/claude-seo.

    18k GitHub starsUsed in 1 repo~441 tokens
    Marketing & SEOAuto-check passed
  • AI Search Visibility Audit

    davepoon/buildwithclaude

    Audit whether a website can be found, crawled, and cited by AI answer engines such as ChatGPT Search, Perplexity, Google AI Overviews, and Microsoft Copilot.

    3.6k GitHub stars~2.4k tokensUpdated 2 days ago
    Marketing & SEOAuto-check passed
  • Geo Fundamentals

    wasp-lang/wasp

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

    19k GitHub starsUsed in 9 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

More from alirezarezvani/claude-skills

All 342 skills in this repo
  • Agile Product Owner

    alirezarezvani/claude-skills

    Writes INVEST-checked user stories with acceptance criteria, splits epics, plans sprints from velocity and ranks the backlog with a weighted score.

    28k GitHub starsUsed in 3 repos~3.2k tokens
    Auto-check passed
  • Product Strategist

    alirezarezvani/claude-skills

    OKR cascade toolkit for product leaders: generates aligned company-to-team OKRs from five strategy types and scores how well they line up.

    28k GitHub starsUsed in 2 repos~1.8k tokens
    Auto-check passed
  • App Store Optimization

    alirezarezvani/claude-skills

    App Store Optimization (ASO) toolkit for researching keywords, analyzing competitor rankings, generating metadata suggestions, and improving app visibility on Apple App Store and Google Play Store.

    28k GitHub starsUsed in 1 repo~4.2k tokens
    Auto-check passed
  • AWS Solution Architect

    alirezarezvani/claude-skills

    Design AWS architectures for startups using serverless patterns and IaC templates.

    28k GitHub starsUsed in 1 repo~2.5k tokens
    Auto-check passed
  • Campaign Analytics

    alirezarezvani/claude-skills

    Calculates attribution, funnel and ROI figures for marketing campaigns with three Python scripts that need only the standard library.

    28k GitHub starsUsed in 1 repo~2.1k tokens
    Auto-check passed
  • Code to PRD

    alirezarezvani/claude-skills

    Reverse-engineers a frontend, backend or fullstack codebase into a product requirements document with per-page docs, an enum dictionary and an API inventory.

    28k GitHub starsUsed in 1 repo~4.9k tokens
    Auto-check passed

Categories

Questions about Aeo

What does Aeo do?

Answer Engine Optimization (AEO) skill — optimize content to be cited by AI language models (ChatGPT, Perplexity, Claude, Gemini, Mistral) as authoritative sources. Aeo is an agent skill from alirezarezvani/claude-skills. Answer Engine Optimization (AEO) skill — optimize content to be cited by AI language models (ChatGPT, Perplexity, Claude, Gemini, Mistral) as authoritative sources.

When should I use Aeo?

Aeo fits situations like: planning content for AI-first search audiences; auditing existing content for E-E-A-T signals; tracking which pages get cited by which LLMs; building a citation-friendly content strategy.

How do I install Aeo in Claude Code?

Run `npx skills add alirezarezvani/claude-skills --skill aeo -a claude-code`. Or copy the skill folder (marketing-skill/skills/aeo in alirezarezvani/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 alirezarezvani/claude-skills --skill aeo -a codex`. Or copy the skill folder (marketing-skill/skills/aeo in alirezarezvani/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 alirezarezvani/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 and pip). Our summary lists: Python 3.

Does Aeo access the network?

SKILL.md names 1 domain. As links in the text: github.com. 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 (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Aeo use?

About 2.7k tokens (SKILL.md is roughly 11k 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 11k 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: Ansvisor Aeo Coach Standalone (ansvisor/ansvisor, 129 stars), SEO Audit (shadcn-labs/agentcn, 486 stars), SEO Profound (AgriciDaniel/claude-seo, 18k stars) and AI Search Visibility Audit (davepoon/buildwithclaude, 3.6k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Aeo?

alirezarezvani (a GitHub user) maintains it in alirezarezvani/claude-skills, which has 27,829 GitHub stars. The repository holds 342 skills in this directory. The repository was last updated on August 30, 2026.

Source: alirezarezvani/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.