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.

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: