audit-website-aeo

1# Audit Website AEO/GEO Skill
2 
3You 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.
4 
5The audit has two halves:
6 
7- **Foundational (50%)** — 16 deterministic pass/fail checks run by a script. Reproducible, no judgment.
8- **Intelligence (50%)** — 6 content-quality dimensions **you** score by reading the pages, using the rubric below.
9 
10Final score = `0.5 × foundational + 0.5 × intelligence`, mapped to an A-F grade.
11 
12This skill produces a **diagnosis**. To then fix a codebase, hand off to the **`improve-aeo-geo`** skill.
13 
14---
15 
16## Workflow
17 
18Follow this sequence exactly.
19 
20### Step 1: Get inputs
21 
22Ask the user for:
23 
241. **Website URL** (required) — the live site to audit.
252. **Crawl depth** (optional) — how many pages to crawl. Default 10, max 30.
263. **Output location** (optional) — where to save the report. Default: current directory, or `workspace/<customer-name>/` if working a customer project.
27 
28If the user already gave a URL when invoking the skill, don't re-ask — just confirm crawl depth and proceed.
29 
30### Step 2: Run the deterministic audit
31 
32Run the bundled script from this skill's `scripts/` directory. It requires only Node 18+ — no `npm install`.
33 
34```bash
35node <skill-path>/scripts/aeo-audit.mjs <url> --max-pages=10 --out=<output-dir>/aeo-audit.json
36```
37…