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.