AEO Audit Claude Skill
The AEO Audit Claude skill crawls a live website and grades how ready it is to be cited by ChatGPT, Claude, Perplexity and Google AI Overviews. It runs 16 scripted checks, scores six content qualities and returns an A to F report with fixes. It is free and open source under the MIT license, from the onvoyage-ai gtm-engineer-skills repo.
git clone https://github.com/onvoyage-ai/gtm-engineer-skills.git && cd gtm-engineer-skillsmkdir -p ~/.claude/skills && ln -s "$PWD/audit-website-aeo" ~/.claude/skills/audit-website-aeonpx skills add onvoyage-ai/gtm-engineer-skills --skill audit-website-aeoWhat the AEO Audit skill does
Most AEO advice is opinion. This skill splits the job in two. A bundled script runs 16 pass or fail checks the same way every time, and Claude then reads the actual page text and scores content quality against a written rubric.
The script checks things like title and meta tags, canonical links, schema, internal links, text depth, robots.txt access for AI crawlers, llms.txt and an RSS feed. Claude then scores answer readiness, quotability, evidence, depth, freshness and structure on a 0 to 5 scale.
The two halves are weighted equally into one score. The skill only diagnoses. It does not edit code, and hands off to a companion skill in the same repo when you want the fixes applied.
- Crawls a live site through its sitemap, robots.txt and internal links, up to 30 pages
- Runs 16 deterministic checks covering meta tags, schema, links, indexability and AI crawler access
- Scores six content dimensions: answer readiness, quotability, evidence, depth, freshness and structure
- Combines both halves into a final score and an A to F grade
- Lists the weakest pages and a prioritized fix list with impact and effort
- Saves the raw JSON results and a markdown audit report to a folder you choose
- Refuses to invent scores if the crawl fails
How it works
Get inputs
It asks for the site URL, an optional crawl depth (default 10 pages, max 30) and where to save the report.
Run the crawler
A Node script crawls the site, runs the 16 checks per page and writes a JSON report with a foundational score.
Read the results
Claude reads the JSON, including the page excerpts, headings and metadata for up to five representative pages.
Score content quality
Claude writes a rationale and then a 0 to 5 score for each of the six content dimensions, from observed text only.
Report and hand off
It computes the final grade, writes the markdown report and recommends the improve-aeo-geo skill if you want code fixes.
Example prompts
Once the AEO Audit skill is installed, ask Claude in plain language. These prompts trigger it:
- Audit https://example.com for AEO and give me a grade
- Run an AEO and GEO audit on my site with a 20 page crawl
- Is my website readable by ChatGPT and Perplexity? Run the audit and list the top three fixes
- Re-run the AEO audit on my site and compare it to last month's score
- Check whether my robots.txt blocks AI crawlers and whether I have an llms.txt
What you get
- An aeo-audit.json file with the check results
- A markdown audit report with the final score and grade
- A pass or fail table for the 16 checks
- A prioritized fix list and the weakest pages
Who it is for
- SEO and content leads who need a baseline before improving AI visibility
- Agencies that want a repeatable AEO audit to show clients before and after
- Developers who want to know which technical signals block AI crawlers
How to install the AEO Audit skill
What you need: Claude Code with Node 18 or newer to run the bundled script. No npm install and no API key.
- Clone
git clone https://github.com/onvoyage-ai/gtm-engineer-skills.git && cd gtm-engineer-skills - Symlink (official)
mkdir -p ~/.claude/skills && ln -s "$PWD/audit-website-aeo" ~/.claude/skills/audit-website-aeo - Skills CLI
npx skills add onvoyage-ai/gtm-engineer-skills --skill audit-website-aeo - Manual
cp -r gtm-engineer-skills/audit-website-aeo ~/.claude/skills/audit-website-aeo
After installing, restart Claude Code or start a new session. Claude loads the AEO Audit skill automatically when your request matches it, or you can ask for it by name.
Tips for better results
- Crawl at least 10 pages so the site-wide checks reflect more than the homepage.
- Run it again after fixes. The score is built to be comparable between runs.
- Use the companion improve-aeo-geo skill if you want the fixes made in your codebase.
Limitations
- It audits a live site only, so it cannot score a staging site that is not reachable.
- The six content scores are Claude's judgment from page excerpts, so treat them as a guide, not a measurement.
AEO Audit Claude skill FAQ
Yes. It is MIT licensed and published at github.com/onvoyage-ai/gtm-engineer-skills. There is no paid tier and no API key. You only need Node 18 or newer for the crawl script.
Clone the repo and symlink the audit-website-aeo folder into ~/.claude/skills, as the README shows. You can also run npx skills add onvoyage-ai/gtm-engineer-skills --skill audit-website-aeo, or copy the folder in by hand.
It needs Claude Code or another agent with a terminal, because the crawl is done by a Node script. Claude.ai cannot run that script, so uploading the folder there would skip the 16 deterministic checks.
AEO means answer engine optimization: making content easy for AI assistants to find, quote and cite. SEO targets ranked links. This skill checks both the technical signals and whether pages give direct, quotable, sourced answers.
Yes. One of the 16 checks reads robots.txt and flags whether it blocks nine major AI crawlers. Others check for noindex, nosnippet-style tags and a valid llms.txt file.