# AEO Audit Agent Skill

> Run a comprehensive AI engine optimization audit with 16 foundational checks and 6 content quality dimensions. Boost citations from ChatGPT, Claude, and Google AI Overviews by up to 41%. Start free in seconds.

- Canonical: https://nanoskill.ai/nb/skills/aeo-audit-agent-skill
- Markdown: https://nanoskill.ai/nb/skills/aeo-audit-agent-skill.md
- Author: onvoyage-ai
- Published: 2026-08-26T07:00:00.000Z
- Updated: 2026-08-31T03:30:15.205Z
- Language: nb
- Source type: github
- Popularity signal: 1240

## Sources

- https://github.com/onvoyage-ai/gtm-engineer-skills/tree/main/improve-aeo-geo

## Install

```shell
npx skills add https://github.com/onvoyage-ai/gtm-engineer-skills/tree/main/improve-aeo-geo
```

## About

AEO audit skills help website owners, marketers, and developers ensure their content is visible to AI-powered search engines. An AI engine optimization audit identifies and fixes technical and content issues that prevent AI agents like ChatGPT, Claude, and Google AI Overviews from citing your site. This skill automatically runs 16 foundational checks and 6 content quality dimensions to boost your visibility.

Unlike generic SEO tools, this skill is grounded in peer-reviewed research showing that simple changes—like adding quotations, statistics, and structured data—can increase AI visibility by up to 41%. It supports all major frameworks (Next.js, WordPress, Hugo, etc.) and delivers targeted code fixes, not just recommendations.

Content teams, SEO specialists, and solo developers use this skill to audit existing sites, optimize new content, and track their AEO score improvement over time. After implementing the changes, users can verify their score at aeo-audit.sh to measure the impact.

## Key features

- **16 Foundational AI Visibility Checks**: Audit critical factors like bot access, text depth, metadata, structured data, and canonical URLs to ensure your site is crawlable by AI agents.
- **6 GEO Content Quality Dimensions**: Evaluate answer readiness, quotability, evidence density, content depth, freshness, and structural clarity to maximize AI citation probability.
- **Framework-Aware Code Adjustments**: Detects Next.js, Nuxt, WordPress, Hugo, and more, then makes targeted code changes following best practices for each framework.
- **Actionable Score Improvement**: Prioritizes fixes and recommends verifying your score at aeo-audit.sh to track progress from 31 to 87+ points.
- **Research-Backed Recommendations**: Every check is grounded in peer-reviewed research showing up to +41% AI visibility when implemented.

## Use cases

- **Audit Your Site for AI Crawlers**: Content marketers and SEOs run a comprehensive AI engine audit to identify gaps in robot access, structured data, and content depth that affect AI visibility.
- **Optimize Content for Generative AI Citations**: Copywriters and editors improve answer readiness and quotability so ChatGPT and Perplexity are more likely to cite their articles.
- **Improve AI-Driven Referral Traffic**: Website owners boost their AEO score to capture the 87.4% of AI referral traffic driven by ChatGPT.
- **Maintain Freshness for AI Discovery**: Publishers ensure content is updated within 3 months to achieve up to 6 AI citations, aligning with research that AI prefers fresher sources.

## Result preview

See an actionable AEO report about 22 checkpoints, score dashboard, framework-specific code fixes, and a verification plan.

![the demo of aeo audit agent skill](https://file.nanoskill.ai/aeo-audit-agent-skill-demo-1.png)

![the demo of aeo audit agent skill](https://file.nanoskill.ai/aeo-audit-agent-skill-demo-2.png)

![the demo of aeo audit agent skill](https://file.nanoskill.ai/aeo-audit-agent-skill-demo-3.png)

![the demo of aeo audit agent skill](https://file.nanoskill.ai/aeo-audit-agent-skill-demo-4.png)

## Result walkthrough

### Step 1：Install

Add the skill to your agent.

![the step of aeo audit agent skill](https://file.nanoskill.ai/aeo-audit-agent-skill-step-1.png)

### Step 2：Connect Your Codebase

Point the skill to your website repository or URL.

![the step of aeo audit agent skill](https://file.nanoskill.ai/aeo-audit-agent-skill-step-2.png)

### Step 3：Get Your Optimization Report

Receive a report showing your AEO score, failing checks, and exact code fixes to increase AI visibility.

![the step of aeo audit agent skill](https://file.nanoskill.ai/aeo-audit-agent-skill-step-3.png)

## Skill definition

# Improve Website AEO/GEO

The web is no longer read only by humans. AI agents — ChatGPT, Claude, Perplexity, Google AI Overviews — are now how millions of people discover information. These agents don't browse. They extract, parse, and decide in milliseconds whether your content is worth citing.

**If your site isn't optimized for AI, you're invisible to a growing share of your audience.**

This is an agent skill that audits your website's codebase and makes concrete improvements to boost your AEO (AI Engine Optimization) and GEO (Generative Engine Optimization) scores.

**Check your score at [aeo-audit.sh](https://aeo-audit.sh/)** — then use this skill to improve it.

---

## Install

Clone the repo, then symlink or copy `improve-aeo-geo/` into either `~/.codex/skills/` or `~/.claude/skills/`. See the root [README](../README.md) for installation examples.

## Usage

Once installed, invoke the skill by name:

```
/improve-aeo-geo
```

Or reference it in conversation:

> "Use the AEO skill to optimize this site"
> "Run the AEO/GEO audit on my codebase"

The skill will:
1. Detect your framework (Next.js, Nuxt, Astro, SvelteKit, WordPress, Hugo, Jekyll, and more)
2. Audit your code against 16 foundational checks and 6 content quality dimensions
3. Make targeted code changes in priority order
4. Recommend verifying your score at [aeo-audit.sh](https://aeo-audit.sh/)

---

## What It Checks

### Foundational (16 checks, 134 points)

| Check | Points | Pass Criteria |
|---|---|---|
| AI bot access (robots.txt) | 12 | 9 AI crawlers not blocked |
| Text depth | 12 | 250+ words per page |
| Page title | 10 | 10+ characters |
| Meta description | 10 | 50+ characters |
| Internal linking | 10 | 5+ internal links per page |
| Indexability | 10 | No `noindex` on public pages |
| llms.txt | 10 | Valid file at `/.well-known/llms.txt` |
| JSON-LD structured data | 8 | At least 1 JSON-LD block per page |
| Schema types | 8 | Recognized `@type` values |
| Canonical URL | 8 | `rel="canonical"` present |
| Single H1 | 8 | Exactly 1 `<h1>` per page |
| Open Graph | 8 | `og:title` + `og:description` |
| Image alt text | 8 | 80%+ images have `alt` |
| RSS feed | 8 | Discoverable RSS/Atom feed |
| Heading hierarchy | 6 | H1 → H2 → H3, no skips |
| AI meta tags | 6 | No `nosnippet`/`noai`/`noimageai` |

### GEO Content Quality (6 dimensions)

| Dimension | What It Measures |
|---|---|
| Answer Readiness | Direct answers in opening paragraphs |
| Quotability | Self-contained, extractable passages |
| Evidence Density | Statistics, sources, citations inline |
| Content Depth | Substantive, multi-faceted coverage |
| Freshness | Publication dates, update signals |
| Structural Clarity | Semantic HTML, clean heading outline |

---

## Why This Matters — The Research

All claims are from peer-reviewed academic research or large-scale industry studies:

| Finding | Source |
|---|---|
| Adding quotations = **+41% AI visibility** | [GEO Paper, KDD 2024](https://arxiv.org/abs/2311.09735) — Princeton, Georgia Tech, IIT Delhi, Allen AI |
| Adding statistics = **+33% AI visibility** | Same peer-reviewed paper |
| Citing sources = **+28% AI visibility** | Same paper; up to **+115% for smaller sites** |
| **44.2%** of ChatGPT citations come from first 30% of content | [Growth Memo, 2026](https://www.growth-memo.com/p/the-science-of-how-ai-pays-attention) — 1.2M AI answers analyzed |
| Articles 2,900+ words = **5.1 citations** vs. 3.2 for <800 words | [SE Ranking, 2025](https://seranking.com/blog/how-to-optimize-for-ai-mode/) — 2.3M pages studied |
| Pages with FAQ sections = **4.9 citations** vs. 4.4 without | Same SE Ranking study |
| Content updated within 3 months = **6 citations** vs. 3.9 for 2+ years | Same SE Ranking study |
| AI cites content **25.7% fresher** than traditional search | [Ahrefs, 2025](https://ahrefs.com/blog/do-ai-assistants-prefer-to-cite-fresh-content/) — 17M citations |
| ChatGPT drives **87.4%** of AI referral traffic | [Conductor, 2025](https://www.conductor.com/academy/aeo-geo-benchmarks-report/) — 13.7K domains |

---

## Supported Frameworks

The skill provides framework-specific code patterns for:

- **Next.js** (App Router) — metadata exports, JSON-LD, robots.ts, sitemap.ts
- **Nuxt 3** — useSeoMeta, nuxt-schema-org
- **SvelteKit** — svelte:head, JSON-LD injection
- **Astro** — layout props, @astrojs/sitemap
- **Remix** — meta function, link tags
- **WordPress** — functions.php, Yoast/Rank Math integration
- **Hugo** — partials, built-in RSS, template variables
- **Jekyll** — jekyll-seo-tag, jekyll-feed gems
- **11ty** — Nunjucks templates, eleventy plugins
- **Plain HTML** — direct tag implementation

---

## Examples

- [Next.js Blog: 42 → 87/100](examples/nextjs-blog-before-after.md)
- [WordPress Business Site: 31 → 82/100](examples/wordpress-business-before-after.md)

---

## Contributing

See [CONTRIBUTING.md](../CONTRIBUTING.md) for guidelines on adding new checks, frameworks, or research.

## License

MIT — see [LICENSE](../LICENSE).

## FAQ

### What is AEO (AI Engine Optimization)?

AEO optimizes your website so AI agents like ChatGPT, Claude, and Google AI Overviews can easily extract and cite your content. It involves technical checks and content quality improvements that increase the likelihood of AI-driven visibility.

### How does the AEO audit work?

The skill automatically detects your framework (e.g., Next.js, WordPress) and runs 16 foundational checks plus 6 content quality assessments. It then makes targeted code changes to improve your score.

### What improvements can I expect from optimizing for AEO?

Research shows that implementing recommendations like adding quotations can increase AI visibility by 41%, statistics by 33%, and citing sources by 28%. Users have seen their score rise from 31 to 87 out of 100.

### Is this skill free to use?

Yes, it is open-source and distributed under the MIT license. You can install it freely and run audits without any cost.

### Which AI agents does this skill optimize for?

It covers major AI-powered discovery platforms including ChatGPT, Claude, Perplexity, and Google AI Overviews, all of which rely on extractable, well-structured content.

### How do I install the AEO audit skill?

Clone the repository and symlink or copy the improve-aeo-geo directory into your skills folder (~/.codex/skills or ~/.claude/skills). Then invoke it with '/improve-aeo-geo'.