# Audit Website Aeo

Audits a live website for AI-engine discoverability (AEO/GEO).

- Repository: https://github.com/onvoyage-ai/gtm-engineer-skills (1345 stars)
- Category: Engineering
- License: MIT
- Last updated: 2026-10-11
- Runs scripts: yes, review before use

## Install

Claude Code: `npx skills add onvoyage-ai/gtm-engineer-skills --skill audit-website-aeo -g -a claude-code -y`
Codex: `npx skills add onvoyage-ai/gtm-engineer-skills --skill audit-website-aeo -g -a codex -y`
Cursor: `npx skills add onvoyage-ai/gtm-engineer-skills --skill audit-website-aeo -g -a cursor -y`
Gemini CLI: `npx skills add onvoyage-ai/gtm-engineer-skills --skill audit-website-aeo -g -a gemini-cli -y`

## Description

Audits a live website for AI-engine discoverability (AEO/GEO). Crawls the site, runs 16 deterministic checks plus a 6-dimension content evaluation, and produces a scored report (A-F) with prioritized fixes. Use to get a baseline before improve-aeo-geo, or to measure progress after changes.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Audit Website AEO/GEO Skill

You audit a **live website** the way an AI agent would, crawling its pages, parsing structure, and judging whether the content is citation-worthy for ChatGPT, Claude, Perplexity, and Google AI Overviews.

The audit has two halves:

- **Foundational (50%)**, 16 deterministic pass/fail checks run by a script. Reproducible, no judgment.
- **Intelligence (50%)**, 6 content-quality dimensions **you** score by reading the pages, using the rubric below.

Final score = `0.5 × foundational + 0.5 × intelligence`, mapped to an A-F grade.

This skill produces a **diagnosis**. To then fix a codebase, hand off to the **`improve-aeo-geo`** skill.

---

## Workflow

Follow this sequence exactly.

### Step 1: Get inputs

Ask the user for:

1. **Website URL** (required), the live site to audit.
2. **Crawl depth** (optional), how many pages to crawl. Default 10, max 30.
3. **Output location** (optional), where to save the report. Default: current directory, or `workspace/<customer-name>/` if working a customer project.

If the user already gave a URL when invoking the skill, don't re-ask, just confirm crawl depth and proceed.

### Step 2: Run the deterministic audit

Run the bundled script from this skill's `scripts/` directory. It requires only Node 18+, no `npm install`.

```bash
node <skill-path>/scripts/aeo-audit.mjs <url> --max-pages=10 --out=<output-dir>/aeo-audit.json
```

The script crawls (sitemap + robots.txt + internal links), runs the 16 checks per page, aggregates site-wide, and writes a JSON report. It also prints a human-readable summary. Tell the user the foundational score and the failed checks.

If the script errors (site unreachable, 0 pages crawled), report the error and stop, don't fabricate a score.

### Step 3: Read the JSON report

Read the `aeo-audit.json` file. The key fields:

The rest: https://github.com/onvoyage-ai/gtm-engineer-skills/blob/HEAD/audit-website-aeo/SKILL.md