# Audit website AEO/GEO skill Human Guide ## What This Is For Audits a live website for AI-engine discoverability (AEO/GEO). It gives the agent a clearer input/output frame for search and SEO workflows: what context to ask for, what decisions to make, and what usable artifact to return. Use this as a human-readable version of the Audit website AEO/GEO skill agent skill. It is meant for marketers, operators, founders, and other non-coders who want the workflow without reading agent-specific implementation instructions. ## When To Use This - Use this when you need a repeatable process for audit website AEO/GEO skill. - Use this when the task needs judgment, examples, constraints, or a clear output format rather than a one-off prompt. - Use this when you want to hand an AI assistant enough context to produce a usable marketing artifact. ## When Not To Use This - Do not use this when you only need a quick factual answer. - Do not use this when the work depends on private data you cannot share with the assistant. - Do not use this as a replacement for legal, compliance, financial, or medical review. ## What You Need Before Starting - The goal or business outcome you want. - The audience, customer segment, or market context. - Any source material the assistant should respect, such as notes, briefs, examples, URLs, or brand guidance. - Constraints such as tone, length, channel, deadline, region, or approval requirements. - A clear definition of what a good final answer should look like. ## Step-By-Step Workflow 1. State the job clearly: "Use the Audit website AEO/GEO skill guide to help me with..." 2. Add context: audience, goal, offer, channel, source material, and constraints. 3. Ask the assistant to identify missing inputs before producing the final output. 4. Have the assistant follow the skill-specific guidance below. 5. Review the result against the final checklist and ask for revisions where needed. ## Skill-Specific Guidance - **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. - **Website URL** (required) — the live site to audit. - **Crawl depth** (optional) — how many pages to crawl. Default 10, max 30. - **Output location** (optional) — where to save the report. Default: current directory, or `workspace//` if working a customer project. - `scoring.foundationalScore` — the deterministic score (0-100). This is **final** — do not change it. - `checks` — the 16 site-wide checks with pass/fail and details. - `prioritizedFixes`, `worstPages`, `coverage`, `heuristicIntelligenceSignals` — supporting context. The heuristic signals are a deterministic *prior* — a sanity check, not the real evaluation. - 0 = No answers; purely promotional or navigational - 1 = Vague content that talks around topics but never directly answers - 2 = Some answers exist but buried deep, not in opening paragraphs - 3 = Several questions answerable; some definition-first or FAQ-style content ## Decision Points And Nuance The original skill emphasizes: Workflow, Step 1: Get inputs, Step 2: Run the deterministic audit, Step 3: Read the JSON report, Step 4: Score the 6 intelligence dimensions, Rubric (0-5 each), Step 5: Compute the final score, Step 6: Write the audit report, Step 7: Hand off, The 16 deterministic checks. Use these questions to steer the work: - What is the intended audience or buyer? - What source material must be preserved? - What should the assistant optimize for: clarity, persuasion, accuracy, speed, creativity, or conversion? - What examples represent the desired quality bar? - What should the assistant avoid? ## Common Mistakes - **Website URL** (required) — the live site to audit. - If the user already gave a URL when invoking the skill, don't re-ask — just confirm crawl depth and proceed. - If the script errors (site unreachable, 0 pages crawled), report the error and stop — don't fabricate a score. - `scoring.foundationalScore` — the deterministic score (0-100). This is **final** — do not change it. - 1 = Vague content that talks around topics but never directly answers - **Never fabricate the crawl.** Always run the script. If it fails, report the failure — don't invent pages or scores. - **The foundational score is the script's output.** Don't recompute or adjust it. - **One report file**, saved to the output directory. Don't scatter partial outputs. ## Copy-And-Paste Prompt ```text Use the Audit website AEO/GEO skill human guide. My goal: [Describe the business outcome] Audience: [Describe who this is for] Context and source material: [Paste notes, examples, links, or existing copy] Constraints: [Tone, length, channel, timeline, must-include items, must-avoid items] Before producing the final output, ask me for any missing information that would materially improve the result. ``` ## Final Checklist - [ ] The output matches the original goal. - [ ] The audience and context are reflected in the answer. - [ ] Important constraints and source material were preserved. - [ ] The assistant made the relevant decisions explicit. - [ ] The final artifact is ready to use, review, or hand to the next person. ## Source This guide was generated from the onvoyage-ai/gtm-engineer-skills skill entry for `audit-website-aeo`. ## Source Skill Notes These notes preserve the nuance from the original skill. Use them as supporting reference when the workflow above feels too generic. # 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//` 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 /scripts/aeo-audit.mjs --max-pages=10 --out=/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: - `scoring.foundationalScore` — the deterministic score (0-100). This is **final** — do not change it. - `checks` — the 16 site-wide checks with pass/fail and details. - `pagesForReview` — up to 5 representative pages (home + richest content pages), each with an `aiView` object containing `title`, `metaDescription`, `h1`, `headings`, `schemaTypes`, `jsonLdSummary`, `textExcerpt`, `internalLinkCount`, `author`, `publishedDate`, `modifiedDate`. **Use these for Step 4.** - `prioritizedFixes`, `worstPages`, `coverage`, `heuristicIntelligenceSignals` — supporting context. The heuristic signals are a deterministic *prior* — a sanity check, not the real evaluation. ### Step 4: Score the 6 intelligence dimensions You are an AI agent that just found this site via web search. A user asked you a question and you landed here. **Decide: would you cite this site in your answer?** Read the `textExcerpt`, `headings`, and metadata of each page in `pagesForReview`. Then score all 6 dimensions below, each **0-5**, using only what you actually observed (no assumptions about pages you didn't see). Write the rationale **before** the score. #### Rubric (0-5 each) **Answer Readiness** — If a user asked a question about this site's topic, could you find a direct answer here? The #1 factor — content answering questions in the first paragraph gets 4.8x more citations. - 0 = No answers; purely promotional or navigational - 1 = Vague content that talks around topics but never directly answers - 2 = Some answers exist but buried deep, not in opening paragraphs - 3 = Several questions answerable; some definition-first or FAQ-style content - 4 = Most common questions answerable; answers lead sections - 5 = Exceptional (dedicated FAQ blocks, definition-first paragraphs, Q&A format throughout) **Quotability** — Can you extract a clean, self-contained 40-60 word passage to quote? Comparison tables get 2.8x citations; FAQ blocks +156%. - 0 = No extractable content (interactive-only, single dense block) - 1 = Content requires full-page context; no passage stands alone - 2 = A few passages extractable but most need surrounding context - 3 = Several self-contained paragraphs; some lists or structured blocks - 4 = Good quotability (tables, lists, FAQ sections, clear answer blocks) - 5 = Highly quotable (comparison tables, step-by-step blocks, definition paragraphs throughout) **Evidence Density** — Statistics, data points, named sources, in-text citations? Adding in-text citations = +115% visibility; statistics = +40% citation rate. - 0 = No evidence; only marketing copy and vague claims - 1 = Vague claims only ("best in class", "industry leading") - 2 = Mostly generalities; rare specific data points - 3 = Some statistics and named sources; cites a few external sources - 4 = High density (numbers, dates, named sources, links to references)