---
spec_name: "Full-Site AEO & Schema Audit (Sonnet 5)"
model: claude-sonnet-5
description: "An agentic workflow that takes a sitemap.xml URL, crawls every page, and produces a prioritized AEO and Schema.org fix list."
---

## AGENT TASK

**Goal:** Perform a comprehensive, site-wide AEO (AI Engine Optimization) and Schema.org audit and deliver a prioritized, actionable report in a markdown table.

**Context:**
-   **Website Sitemap:** [PASTE YOUR SITEMAP.XML URL HERE]
-   **Primary Audience:** [DESCRIBE YOUR TARGET AUDIENCE, e.g., 'Solo designers and creative directors']
-   **Business Goal:** [DESCRIBE THE SITE'S MAIN GOAL, e.g., 'Generate leads for a design agency']
-   **Pillar Content Hubs:** [LIST ANY KEY PILLAR PAGE URLS, e.g., `https://mikekwal.com/blog/aeo-pack/`]

**Execution Steps:**

1.  **Initialization:** Announce that you are starting the AEO audit and state the target sitemap URL.

2.  **Sitemap Processing:**
    -   Use your browser tool to fetch the content of the sitemap URL provided.
    -   Parse the XML to extract a complete list of all unique page URLs. Ignore image, video, or non-page URLs.
    -   Announce the total number of pages you will be auditing.

3.  **Per-Page Analysis:**
    -   Iterate through each URL from the list.
    -   For each URL, fetch the full HTML content of the page.
    -   Analyze the content against the following AEO and Schema criteria:
        -   **Schema.org Markup:** Check for the presence of a `<script type="application/ld+json">` block. Identify the `@type` (e.g., `Article`, `FAQPage`, `Product`, `Organization`). Note if schema is missing or incomplete.
        -   **Answer-First H2s:** Scan the content under each `<h2>` tag. Does the first paragraph (40-60 words) provide a direct, standalone answer to the question implied by the heading? Score this from 1 (no) to 5 (yes).
        -   **Topical Focus:** Evaluate if the page content is focused on a single, clear topic. Note pages that seem to cover too many disparate subjects.
        -   **Recency Signals:** Look for explicit text indicating when the content was last updated (e.g., "Last updated: July 2026").
        -   **Internal Linking:** Check for the presence of at least one internal link to the provided pillar content hubs.

4.  **Reporting:**
    -   After analyzing all pages, consolidate your findings into a single data structure.
    -   Generate a final report formatted as a single markdown table with the following columns:
        -   `URL`: The full URL of the page.
        -   `Schema Type`: The `@type` found, or "Missing".
        -   `AEO Score (1-10)`: Your calculated score based on the analysis (give heavier weight to schema and answer-first H2s).
        -   `Top 3 Recommended Fixes`: A bulleted list of the three most impactful, actionable changes for that specific page.

5.  **Prioritization & Final Output:**
    -   Sort the table rows in ascending order based on the `AEO Score (1-10)` column, so the pages needing the most work are at the top.
    -   Present the final, sorted markdown table as your output.
    -   Conclude with a one-sentence summary of the site's overall AEO health.