aeo

Audits websites for AI-crawler access, raw-HTML visibility, and citation readiness, producing severity-labelled findings and a plan.

Updated Aug 10, 2026
One-click install
npx skills add https://github.com/ledtorch/coding-agent-workflow --skill aeo-ledtorch
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: aeo
Source: https://github.com/ledtorch/coding-agent-workflow/tree/main/skills/aeo
Command: npx skills add https://github.com/ledtorch/coding-agent-workflow --skill aeo-ledtorch

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? AI assistants and answer engines may be unable to reach, read, or cite your website, and the causes — WAF blocks, JavaScript-only rendering, missing citations — are invisible to classic SEO audits. This Skill diagnoses exactly why AI engines ignore a site, without changing anything. ## Core Features & Use Cases - Eight evidence-tiered checks: Crawler access (robots.txt vs. WAF reality), raw-HTML visibility, answer-first structure, citations/statistics, freshness signals, entity/schema signals, technical hygiene, and llms.txt — each capped in severity by its evidence tier (PROVEN / PLAUSIBLE / SPECULATIVE). - Ground-truth fetching: Fetches pages with real AI-crawler user agents (OAI-SearchBot, ClaudeBot, PerplexityBot) and audits the raw HTML, not what a browser renders. - Findings plus plan doc: Delivers a per-check verdict table, severity-labelled findings with commands and failure scenarios, and a plan doc — while editing nothing. - Use Case: Before a product launch, run the audit against your marketing site to discover that a legacy GPTBot block also excludes OAI-SearchBot, silently removing you from ChatGPT Search. ## Quick Start Ask the agent to run an AEO audit on your site's URL, for example: audit https://example.com for AI search readiness.

Frequently Asked Questions about aeo

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I check if AI crawlers can access my website?▼

Fetch your robots.txt and grep for AI user agents like OAI-SearchBot, Claude-SearchBot, and PerplexityBot, then fetch a page with a crawler user-agent string to confirm a 200 response. Robots.txt permission alone is not proof — WAF and CDN bot rules can silently 403 crawlers that robots.txt invites.

How to audit a website for AI search and answer engines?▼

Run eight ordered checks: crawler access, raw-HTML visibility, answer-first heading structure, citations and statistics, freshness signals, entity/schema markup, technical hygiene, and llms.txt. Audit the raw HTML fetched without JavaScript execution, since most AI crawlers never render pages.

Does blocking GPTBot remove my site from ChatGPT Search?▼

No — GPTBot controls training data only, while OAI-SearchBot controls ChatGPT Search citations and ChatGPT-User handles live fetches. Each operator maintains separate user agents per class, so blocking one class does not block the others; verify each class individually.

Can AI crawlers read JavaScript-rendered content?▼

No — GPTBot, ClaudeBot, and PerplexityBot read only the initial HTML response and do not execute JavaScript; only Gemini, riding Googlebot's infrastructure, renders JS. Client-rendered content inside an empty root div is invisible to every other AI engine.

Does adding llms.txt improve AI search citations?▼

Evidence is weak — server-log studies show roughly 0.1% of AI-bot traffic touches llms.txt, and no major engine commits to consuming it for search. It earns a place mainly for docs-heavy or agent-facing developer sites, and should never be flagged as a critical finding.

What are the limitations of an AEO audit?▼

The audit fixes nothing — it ends in findings and a plan doc, leaving all edits to the user. Repo-only mode cannot prove live reachability, and sampled pages may not represent the whole site, so unverified areas are declared explicitly in the report.