What is the Improve AEO GEO agent skill?

Provides expert guidance for at AI Engine Optimization (AEO) and Generative Engine Optimization (GEO). It stands out by giving search and SEO workflows a defined shape, so the agent asks for better context and returns a more usable result.

What inputs does Improve AEO GEO need?

Context for search and SEO workflows: your goals, audience, constraints, and any source material the skill asks for.

What does Improve AEO GEO output?

A ready-to-use result for search and SEO workflows: the analysis, copy, or recommendations the agent produces.

Improve AEO GEO

Quick answer

01What is it?: Provides expert guidance for at AI Engine Optimization (AEO) and Generative Engine Optimization (GEO). It stands out by giving search and SEO workflows a defined shape, so the agent asks for better context and returns a more usable result.
02Inputs: Context for search and SEO workflows: your goals, audience, constraints, and any source material the skill asks for.
03Output: A ready-to-use result for search and SEO workflows: the analysis, copy, or recommendations the agent produces.

Add this skill

Install-only

Install as a package

Installs this one skill package for your coding agent, including any supporting files that skill ships with — not every skill in the repository. Read the tutorial.

Terminal

$ npx skills add onvoyage-ai/gtm-engineer-skills --skill improve-aeo-geo

Skill instructions

The instruction file for this skill. The skill also includes other files you need to install to use it.

SKILL.md

Preview only — coding agent install

Improve Website AEO/GEO Skill

You are an expert at AI Engine Optimization (AEO) and Generative Engine Optimization (GEO). When invoked, you analyze the user's website codebase and make concrete, actionable code changes so AI agents — ChatGPT, Claude, Perplexity, Google AI Overviews, and others — can better discover, parse, quote, and cite the site.

The web is shifting from human-first to AI-first discovery. AI agents don't browse like humans. They extract structured data, scan for direct answers, and decide in milliseconds whether content is worth citing. This skill makes websites visible to that new audience.

Workflow

When invoked on a codebase, follow this exact sequence:

Step 1: Baseline

If the user has a live URL, get a baseline score first. Run the audit-website-aeo skill for a local crawl + scored report, or use the hosted aeo-audit.sh (https://aeo-audit.sh). If an aeo_audit_report.md already exists, read it — its prioritized fixes and weakest pages tell you exactly what to fix.
If no URL is available, proceed with a code-level audit.

Step 2: Discover the stack

Identify the framework (Next.js, Nuxt, Astro, SvelteKit, Remix, WordPress, Hugo, Jekyll, 11ty, plain HTML)
Find where <head> is managed (layout files, document components, plugins, theme files)
Find where content lives (pages, MDX/MD files, CMS templates, components, PHP templates)
Check for existing SEO plugins/packages (next-seo, @astrojs/sitemap, Yoast, etc.)
Check if the site uses SSR, SSG, or client-side rendering

Step 3: Audit existing state

Run through all checks below. For each failing check, note the file(s) to modify and the specific fix.

Step 4: Fix in priority order

Apply changes starting with Priority 1 (blockers), then work down. Make the smallest, most targeted changes needed.

Step 5: Verify

Re-run the audit (audit-website-aeo skill, or aeo-audit.sh (https://aeo-audit.sh)) and compare against the Step 1 baseline to confirm the score improved
Target: 80+ overall score (B+ grade or higher)

Scoring Model

The AEO audit score combines two halves:

Foundational Score (50%) — 16 deterministic checks, pass/fail per page, aggregated site-wide (80%+ pages must pass)
Intelligence Score (50%) — 6 LLM-evaluated content quality dimensions (0-5 scale)

Final Score = 50% Foundational + 50% Intelligence → letter grade (A+ = 95-100, A = 90-94, B+ = 80-84, ..., F = below 40).

Priority 1: Blockers (fix these first)

AI Bot Access (12 pts)

robots.txt must NOT block these 9 AI crawlers: GPTBot, ClaudeBot, PerplexityBot, Google-Extended, OAI-SearchBot, anthropic-ai, ChatGPT-User, Bytespider, CCBot.

Fix: Open robots.txt (project root, public/robots.txt, or framework equivalent). Remove any Disallow rules for these bots. If no robots.txt exists, create one:

User-agent: *
Allow: /

User-agent: GPTBot
Allow: /

User-agent: ClaudeBot
Allow: /

User-agent: PerplexityBot
Allow: /

User-agent: Google-Extended
Allow: /

User-agent: OAI-SearchBot
Allow: /

User-agent: anthropic-ai
Allow: /

User-agent: ChatGPT-User
Allow: /

User-agent: Bytespider
Allow: /

User-agent: CCBot
Allow: /

Sitemap: https://YOURDOMAIN.com/sitemap.xml

If AI bots are blocked, nothing else matters. This is the #1 prerequisite.

AI-Accessible Meta Tags (6 pts)

Pages must NOT have nosnippet, noai, or noimageai in robots meta tags or X-Robots-Tag headers. Search for these and remove from public content pages.

Indexability (10 pts)

Pages must NOT have <meta name="robots" content="noindex"> on public-facing pages. Search codebase for noindex and remove where inappropriate.

Priority 2: High-Impact Structure

Structured Data / JSON-LD (8 pts)

Every page needs at least 1 <script type="application/ld+json"> block. Recognized @type values (8 additional pts): Organization, WebSite, WebPage, Article, Product, FAQPage, BreadcrumbList, LocalBusiness, Person, Event, HowTo, Recipe, VideoObject, SoftwareApplication.

Minimum setup:

Site-wide: Organization schema in the root layout
Homepage: WebSite schema with SearchAction
Blog posts: Article schema with author, datePublished, dateModified
Product pages: Product schema
FAQ sections: FAQPage schema

Page Titles (10 pts)

Every <title> must be 10+ characters. Each page needs a unique, descriptive title. Format: [Page Topic] | [Brand]. Aim for 50-60 characters.

Meta Descriptions (10 pts)

Every page needs <meta name="description"> with 50+ characters. Write unique descriptions (120-160 chars ideal). Lead with the answer/value, not filler.

Text Depth (12 pts)

Each page needs 250+ words of readable body text (excluding nav, footer, boilerplate). Aim for 500-2000 words on key pages. Articles over 2,900 words average 5.1 AI citations vs. 3.2 for under 800 words (SE Ranking, 2025 — 2.3M pages analyzed).

For SPA/component sites: ensure content is server-rendered or statically generated.

llms.txt (10 pts)

Create /.well-known/llms.txt with a heading, links, and 100+ characters:

# [Your Site Name]

> Brief description of what your site/product does.

## Documentation
- [Getting Started](https://yourdomain.com/docs/getting-started)
- [API Reference](https://yourdomain.com/docs/api)

## Key Pages
- [About](https://yourdomain.com/about)
- [Pricing](https://yourdomain.com/pricing)
- [Blog](https://yourdomain.com/blog)

## Policies
- [Terms of Service](https://yourdomain.com/terms)
- [Privacy Policy](https://yourdomain.com/privacy)

Also consider creating llms-full.txt with the complete content of key pages inlined for direct LLM consumption.

Priority 3: Content Quality

Heading Hierarchy (6 pts)

Proper H1 → H2 → H3 nesting. Exactly 1 <h1> per page (8 pts). 2+ heading levels. No skips (H1 → H3 without H2 is wrong). Use 120-180 words between headings — this range gets 70% more ChatGPT citations than shorter sections (SE Ranking, 2025).

Internal Linking (10 pts)

5+ internal links per page. Use descriptive anchor text. Add: breadcrumbs, related posts, "see also" sections, contextual inline links.

Canonical URL (8 pts)

Every page needs <link rel="canonical" href="..."> with an absolute URL. Handle trailing slashes consistently.

Open Graph (8 pts)

Every page needs og:title and og:description. Also add og:image, og:url, og:type.

Image Alt Coverage (8 pts)

80%+ of <img> tags must have alt attributes. Decorative images: alt="".

Alt text should describe the conclusion, not the visual form. AI engines and screen readers both need the takeaway:

BAD: alt="bar chart" or alt="graph showing results"
GOOD: alt="GEO-optimized pages earn 41% more AI citations (KDD 2024, N=10K queries)"

For charts and data visuals: the image alone is invisible to LLMs. Every chart needs a text summary and HTML data table alongside it — that's what AI actually cites. Use the create-geo-charts skill for data visualizations that need the full GEO text layer.

RSS/Atom Feed (8 pts)

Publish a feed and add the discovery link:

<link rel="alternate" type="application/rss+xml" title="RSS Feed" href="/feed.xml" />

Sitemap with lastmod

Not scored directly but critical for freshness signals. Generate sitemap.xml with <lastmod> dates. Reference it from robots.txt.

Priority 4: GEO Content Optimization

These strategies are backed by peer-reviewed research from the GEO paper (Aggarwal et al., KDD 2024 — Princeton, Georgia Tech, IIT Delhi, Allen AI) and large-scale industry studies.

Add Quotations from Authoritative Sources (+41% visibility)

The single most effective GEO strategy. Include direct quotes from experts, studies, or official sources. This is the #1 optimization per the GEO paper.

WEAK: "Experts say this approach works well."
STRONG: "As Dr. Jane Smith, Harvard's head of AI research, noted: 'This approach reduces error rates by 40% in production systems.'"

Add Statistics and Data Points (+33% visibility)

The #2 GEO strategy. Include specific numbers, percentages, dates, and measurements. Every 150-200 words should contain at least one data point.

WEAK: "Our platform is significantly faster."
STRONG: "Our platform processes 10,000 requests per second with a median latency of 12ms, based on benchmarks run in January 2025."

Cite Sources with In-Text References (+28% visibility)

The #3 GEO strategy. Name sources inline. Link to studies, reports, and official documentation.

WEAK: "Studies show this is effective."
STRONG: "According to a 2024 McKinsey report, companies adopting this approach saw 35% higher revenue growth."

Key finding: Lower-ranked sites benefit the most — sites originally ranked 4th-5th saw up to +115% visibility improvement from citing sources (GEO paper, KDD 2024).

Answer-First Content Structure

44.2% of ChatGPT citations come from the first 30% of page content (Kevin Indig, Growth Memo, 2026 — 1.2M AI answers analyzed). Lead every section with the direct answer:

[H2: Question-format heading]
[1-2 sentence direct answer]
[Supporting detail with evidence]
[Statistic or source citation]
[Internal link to related content]

Before: "Our company was founded in 2015 with a vision to transform..." After: "[Product] is a [category] tool that [primary function]. It helps [audience] achieve [specific outcome], reducing [metric] by [X]%."

FAQ Sections

Pages with FAQ sections average 4.9 AI citations vs. 4.4 without (SE Ranking, 2025 — 2.3M pages). The FAQ content matters more than FAQ schema markup. Add both:

<section>
  <h2>Frequently Asked Questions</h2>
  <h3>What is [topic]?</h3>
  <p>[Direct answer]. [Supporting detail with evidence].</p>
  <h3>How does [topic] work?</h3>
  <p>[Step-by-step explanation].</p>
</section>

Plus FAQPage JSON-LD schema for the section.

Quotable Blocks

Write self-contained paragraphs that make sense when extracted in isolation:

40-60 words per block
No pronouns referring to prior context ("it", "this")
Name the subject explicitly
End with a concrete fact or number
Use comparison tables, numbered lists, and definition blocks

Freshness Signals

AI agents cite fresher content. Content updated within 3 months averages 6 citations vs. 3.9 for 2+ year old content (SE Ranking, 2025). AI assistants cite content 25.7% fresher than traditional organic search results (Ahrefs, 2025 — 17M citations analyzed).

Add to every content page:

<meta property="article:published_time" content="2025-01-15T00:00:00Z" />
<meta property="article:modified_time" content="2025-06-01T00:00:00Z" />

Show "Last updated: [date]" visibly on the page. Maintain a blog or changelog with regular updates.

Structural Clarity

Use semantic HTML: <main>, <article>, <section>, <nav>, <aside>. Content with clear H2/H3 hierarchy is 2.8x more likely to earn citations (AirOps, 2025). Ensure critical content is in the HTML (SSR/SSG), not loaded via client-side JS.

Framework-Specific Patterns

Next.js (App Router)

Metadata (app/page.tsx or app/layout.tsx):

import type { Metadata } from 'next'

export const metadata: Metadata = {
  title: 'Page Title | Brand',
  description: 'Descriptive meta description of 120-160 characters.',
  alternates: { canonical: 'https://yourdomain.com/page' },
  openGraph: {
    title: 'Page Title',
    description: 'Social sharing description.',
    url: 'https://yourdomain.com/page',
    images: [{ url: 'https://yourdomain.com/og-image.jpg' }],
  },
  robots: { index: true, follow: true },
}

JSON-LD:

export default function Page() {
  const jsonLd = {
    '@context': 'https://schema.org',
    '@type': 'Article',
    headline: 'Article Title',
    datePublished: '2025-01-15',
    dateModified: '2025-06-01',
    author: { '@type': 'Person', name: 'Author Name' },
  }
  return (
    <>
      <script type="application/ld+json" dangerouslySetInnerHTML={{ __html: JSON.stringify(jsonLd) }} />
      <article><h1>Article Title</h1>{/* Content */}</article>
    </>
  )
}

robots.txt (app/robots.ts):

import type { MetadataRoute } from 'next'
export default function robots(): MetadataRoute.Robots {
  return {
    rules: [
      { userAgent: '*', allow: '/' },
      { userAgent: 'GPTBot', allow: '/' },
      { userAgent: 'ClaudeBot', allow: '/' },
      { userAgent: 'PerplexityBot', allow: '/' },
      { userAgent: 'Google-Extended', allow: '/' },
      { userAgent: 'OAI-SearchBot', allow: '/' },
      { userAgent: 'anthropic-ai', allow: '/' },
      { userAgent: 'ChatGPT-User', allow: '/' },
      { userAgent: 'Bytespider', allow: '/' },
      { userAgent: 'CCBot', allow: '/' },
    ],
    sitemap: 'https://yourdomain.com/sitemap.xml',
  }
}

Sitemap (app/sitemap.ts):

import type { MetadataRoute } from 'next'
export default function sitemap(): MetadataRoute.Sitemap {
  return [
    { url: 'https://yourdomain.com', lastModified: new Date(), changeFrequency: 'weekly', priority: 1 },
    { url: 'https://yourdomain.com/about', lastModified: new Date(), changeFrequency: 'monthly', priority: 0.8 },
  ]
}

Nuxt 3

Metadata (in app.vue or page components):

<script setup>
useSeoMeta({
  title: 'Page Title | Brand',
  description: 'Descriptive meta description.',
  ogTitle: 'Page Title',
  ogDescription: 'Social sharing description.',
  ogImage: 'https://yourdomain.com/og-image.jpg',
})
useHead({
  link: [{ rel: 'canonical', href: 'https://yourdomain.com/page' }],
})
</script>

JSON-LD (using useSchemaOrg from nuxt-schema-org):

<script setup>
useSchemaOrg([
  defineArticle({
    headline: 'Article Title',
    datePublished: '2025-01-15',
    dateModified: '2025-06-01',
    author: { name: 'Author Name' },
  }),
])
</script>

SvelteKit

Metadata (in +page.svelte or +layout.svelte):

<svelte:head>
  <title>Page Title | Brand</title>
  <meta name="description" content="Descriptive meta description." />
  <link rel="canonical" href="https://yourdomain.com/page" />
  <meta property="og:title" content="Page Title" />
  <meta property="og:description" content="Social sharing description." />
</svelte:head>

JSON-LD:

<svelte:head>
  {@html `<script type="application/ld+json">${JSON.stringify({
    "@context": "https://schema.org",
    "@type": "Article",
    "headline": "Article Title",
    "datePublished": "2025-01-15"
  })}</script>`}
</svelte:head>

Astro

Layout (src/layouts/Base.astro):

---
const { title, description, canonical, publishedDate } = Astro.props
---
<head>
  <title>{title}</title>
  <meta name="description" content={description} />
  <link rel="canonical" href={canonical} />
  <meta property="og:title" content={title} />
  <meta property="og:description" content={description} />
  {publishedDate && <meta property="article:published_time" content={publishedDate} />}
  <link rel="alternate" type="application/rss+xml" title="RSS Feed" href="/feed.xml" />
</head>

Use @astrojs/sitemap for automatic sitemap generation with lastmod.

WordPress

functions.php — Add JSON-LD:

function add_json_ld_schema() {
  if (is_singular('post')) {
    $schema = [
      '@context' => 'https://schema.org',
      '@type' => 'Article',
      'headline' => get_the_title(),
      'datePublished' => get_the_date('c'),
      'dateModified' => get_the_modified_date('c'),
      'author' => ['@type' => 'Person', 'name' => get_the_author()],
    ];
    echo '<script type="application/ld+json">' . json_encode($schema) . '</script>';
  }
}
add_action('wp_head', 'add_json_ld_schema');

robots.txt — WordPress manages via Settings > Reading. Add AI bot rules via a plugin (Yoast, Rank Math) or a custom robots.txt in the web root.

llms.txt — Create .well-known/llms.txt in the WordPress root directory, or use a plugin/rewrite rule.

Hugo

Metadata (in layouts/partials/head.html):

<title>{{ .Title }} | {{ .Site.Title }}</title>
<meta name="description" content="{{ .Description }}" />
<link rel="canonical" href="{{ .Permalink }}" />
<meta property="og:title" content="{{ .Title }}" />
<meta property="og:description" content="{{ .Description }}" />
{{ if .Date }}<meta property="article:published_time" content="{{ .Date.Format "2006-01-02T15:04:05Z07:00" }}" />{{ end }}
{{ if .Lastmod }}<meta property="article:modified_time" content="{{ .Lastmod.Format "2006-01-02T15:04:05Z07:00" }}" />{{ end }}

JSON-LD (in layouts/partials/schema.html):

{{ if .IsPage }}
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Article",
  "headline": "{{ .Title }}",
  "datePublished": "{{ .Date.Format "2006-01-02" }}",
  "dateModified": "{{ .Lastmod.Format "2006-01-02" }}",
  "author": { "@type": "Person", "name": "{{ .Params.author | default .Site.Params.author }}" }
}
</script>
{{ end }}

Hugo generates RSS at /index.xml by default. Use hugo --minify for clean HTML output.

Jekyll / 11ty

Jekyll — Use jekyll-seo-tag and jekyll-sitemap gems. Add JSON-LD in _includes/head.html. RSS via jekyll-feed gem.

11ty — Use @11ty/eleventy-plugin-rss for feeds. Add metadata via Nunjucks/Liquid templates in _includes/base.njk. Generate sitemap with a custom template or eleventy-plugin-sitemap.

Remix

Metadata (in route meta function):

export const meta: MetaFunction = () => [
  { title: 'Page Title | Brand' },
  { name: 'description', content: 'Descriptive meta description.' },
  { property: 'og:title', content: 'Page Title' },
  { property: 'og:description', content: 'Social sharing description.' },
  { tagName: 'link', rel: 'canonical', href: 'https://yourdomain.com/page' },
]

Verification Checklist

After making changes, confirm:

robots.txt allows all 9 AI bots
No noindex, nosnippet, noai on public pages
Every page has: title (10+ chars), meta description (50+ chars), canonical URL
Every page has: exactly 1 H1, proper heading hierarchy (H1 → H2 → H3)
Every page has: JSON-LD with recognized @type
Every page has: og:title + og:description
Every page has: 250+ words of body content
Every page has: 5+ internal links
80%+ images have alt text
/.well-known/llms.txt exists and is valid
RSS/Atom feed exists and is discoverable via <link> tag
Sitemap.xml exists with <lastmod> dates
Publication/modification dates on content pages (meta + visible)
Content leads with direct answers, not preamble
FAQ sections on key pages with FAQPage schema
Statistics and named sources cited inline
Authoritative quotations included where relevant

Target: 80+ AEO score (B+ grade or higher). Validate at aeo-audit.sh (https://aeo-audit.sh).

Research References

All statistics in this skill are from verifiable, peer-reviewed or large-scale primary research:

Claim	Source
Quotations = +41% visibility; Statistics = +33%; Cite Sources = +28%	Aggarwal et al., "GEO: Generative Engine Optimization," KDD 2024 (arXiv (https://arxiv.org/abs/2311.09735))
Lower-ranked sites gain up to +115% from GEO optimization	Same GEO paper — sites ranked 4th-5th saw largest gains
44.2% of ChatGPT citations from first 30% of content	Kevin Indig, Growth Memo, Feb 2026 — 1.2M AI answers, 18K citations
Articles 2,900+ words = 5.1 citations vs. 3.2 for <800 words	SE Ranking, Nov 2025 — 2.3M pages, 295K domains
120-180 words per section = 70% more ChatGPT citations	Same SE Ranking study
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+ year old	Same SE Ranking study
AI cites content 25.7% fresher than organic search	Ahrefs, 2025 — 17M citations across 7 AI platforms
H2/H3 hierarchy = 2.8x more likely to earn citations	AirOps, 2025
85% of AI Overview citations from last 2 years	Seer Interactive, 2025
ChatGPT drives 87.4% of AI referral traffic	Conductor, Nov 2025 — 13.7K domains, 3.3B sessions

Supporting file: README.md

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:

Detect your framework (Next.js, Nuxt, Astro, SvelteKit, WordPress, Hugo, Jekyll, and more)
Audit your code against 16 foundational checks and 6 content quality dimensions
Make targeted code changes in priority order
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

Contributing

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

License

MIT — see LICENSE (../LICENSE).

Supporting file: examples/nextjs-blog-before-after.md

Example: Next.js Blog — Before & After

A typical Next.js blog scoring 42/100 (D) improved to 87/100 (A-) with these changes.

Before: What was wrong

Score: 42/100 (D)
Foundational: 5/16 checks passing
Intelligence: 2.1/5 average

Failing checks:
- AI bots blocked (robots.txt had Disallow: / for GPTBot, ClaudeBot)
- No JSON-LD on any page
- No llms.txt
- No RSS feed
- No canonical URLs
- No OG tags
- Thin content on 60% of pages (<250 words)
- Multiple H1s on homepage (logo + hero title)
- No meta descriptions on blog posts

Changes Made

1. robots.txt (Priority 1 — Blocker)

File: public/robots.txt

- User-agent: GPTBot
- Disallow: /
- User-agent: ClaudeBot
- Disallow: /
+ User-agent: *
+ Allow: /
+
+ User-agent: GPTBot
+ Allow: /
+
+ User-agent: ClaudeBot
+ Allow: /
+
+ Sitemap: https://myblog.com/sitemap.xml

2. JSON-LD structured data (Priority 2)

File: app/layout.tsx — Added Organization schema site-wide:

// Added to RootLayout
<script
  type="application/ld+json"
  dangerouslySetInnerHTML={{
    __html: JSON.stringify({
      '@context': 'https://schema.org',
      '@type': 'Organization',
      name: 'My Blog',
      url: 'https://myblog.com',
      logo: 'https://myblog.com/logo.png',
    }),
  }}
/>

File: app/blog/[slug]/page.tsx — Added Article schema to each post:

const jsonLd = {
  '@context': 'https://schema.org',
  '@type': 'Article',
  headline: post.title,
  datePublished: post.publishedAt,
  dateModified: post.updatedAt,
  author: { '@type': 'Person', name: post.author },
}

3. Metadata (Priority 2)

File: app/blog/[slug]/page.tsx — Added generateMetadata:

export async function generateMetadata({ params }): Promise<Metadata> {
  const post = await getPost(params.slug)
  return {
    title: `${post.title} | My Blog`,
    description: post.excerpt, // 120-160 chars
    alternates: { canonical: `https://myblog.com/blog/${params.slug}` },
    openGraph: {
      title: post.title,
      description: post.excerpt,
      images: [{ url: post.coverImage }],
    },
  }
}

4. llms.txt (Priority 2)

File: public/.well-known/llms.txt — Created:

# My Blog

> A developer blog covering React, TypeScript, and AI engineering.

## Popular Posts
- [Building with Next.js App Router](https://myblog.com/blog/nextjs-app-router)
- [TypeScript Best Practices 2025](https://myblog.com/blog/typescript-2025)

## About
- [About the Author](https://myblog.com/about)

5. RSS Feed (Priority 3)

File: app/feed.xml/route.ts — Created RSS route handler generating valid XML feed.

File: app/layout.tsx — Added discovery link:

<link rel="alternate" type="application/rss+xml" title="RSS" href="/feed.xml" />

6. Content improvements (Priority 4)

Rewrote blog post intros from:

"In this post, we'll explore the various ways you can..."

To:

"[Topic] is [definition]. It solves [problem] by [mechanism]. Here's how to implement it in [framework]."

Added FAQ sections to 5 key posts with FAQPage schema.

After

Score: 87/100 (A-)
Foundational: 15/16 checks passing (image alt at 75%, just below 80% threshold)
Intelligence: 4.0/5 average

Remaining fix: Add alt text to 12 images to hit 80% coverage.

Time spent

~45 minutes with Claude Code using this skill.

Supporting file: examples/wordpress-business-before-after.md

Example: WordPress Business Site — Before & After

A small business WordPress site scoring 31/100 (F) improved to 82/100 (B+).

Before: What was wrong

Score: 31/100 (F)
Foundational: 3/16 checks passing
Intelligence: 1.8/5 average

Failing checks:
- AI bots blocked (security plugin blocked all bots by default)
- nosnippet meta tag on all pages (added by theme)
- No JSON-LD
- No llms.txt
- No RSS feed discovery link
- No canonical URLs
- Homepage had 80 words total
- Product pages had no meta descriptions
- Images had no alt text
- No heading hierarchy (H1 used for styling, H4 for content)

Key Changes

1. Unblocked AI bots

Removed Wordfence rule blocking GPTBot, ClaudeBot, etc.
Removed nosnippet from theme's header.php

2. Added JSON-LD via functions.php

Organization schema on all pages
Product schema on product pages
Article schema on blog posts

3. Content depth

Expanded homepage from 80 words to 650 words
Added "What we do", "Who we serve", FAQ section
Each product page expanded with: description, use cases, specifications, FAQ

4. Heading hierarchy fix

Changed H1 from logo to page title
Restructured content: H1 (page title) → H2 (sections) → H3 (details)

5. Meta & technical

Added Yoast SEO, configured meta descriptions for all pages
Added canonical URLs via Yoast
Created llms.txt in web root
Added RSS discovery link to header.php

6. GEO content improvements

Added customer testimonials with names and companies (quotations)
Added performance statistics: "Serving 500+ clients since 2018"
Added FAQ sections to 4 key pages with FAQPage schema

After

Score: 82/100 (B+)
Foundational: 14/16 checks passing
Intelligence: 3.6/5 average

Common questions

How do I install Improve AEO GEO in Cursor, Claude Code, or Codex?

Run npx skills add onvoyage-ai/gtm-engineer-skills --skill improve-aeo-geo in the project where you want it, then ask your agent for the skill by name. The --skill flag installs only Improve AEO GEO, not every skill in the repository.

Where does Improve AEO GEO come from and what license is it under?

Improve AEO GEO comes from the onvoyage-ai/gtm-engineer-skills repository on GitHub. That repository has 1.2K GitHub stars. The skill is published under the MIT license.

Prefer plain text? Read the Improve AEO GEO guide as markdown.