SEO Aeo Audit — Security skill for Claude Code

seo-aeo-audit /SKILL by https://flyweel.co

A framework-agnostic SEO + AEO (Answer-Engine Optimization) audit skill for Claude Code. Point it at any live website on any framework and it produces a prioritized improvement report with stack-specific code fixes — plus a plain-English summary for non-technical stakeholders.

Works as a Claude Code skill (install once, invoke from any repo) or as a standalone CLI tool.

---

What it does

Given a URL, the tool:

1. Discovers your site structure via sitemap + homepage crawl
2. Classifies pages into templates (home, product, pricing, blog, docs, etc.) and samples one representative per template (~10-15 pages)
3. Fetches each page — httpx for static HTML, Playwright fallback for SPAs
4. Parses meta tags, OG/Twitter, canonical, hreflang, robots, headings, word count, image alt coverage, internal link graph, and every JSON-LD block
5. Detects the framework (Next.js, Astro, Nuxt, SvelteKit, Gatsby, Remix, WordPress, Shopify, etc.)
6. Scores SEO and AEO on a 0-100 scale
7. Synthesizes two reports:
   • Technical report (report.md + report.docx) — for the web/content team. Full finding list with framework-specific code fixes.
   • Layman summary (summary.md + summary.docx) — for stakeholders. Plain-English traffic-light health check, top 5 priorities with effort estimates, and a strategic ideas & guidance section.

**80% of the report is technical checks the Python analyzer runs deterministically.** The other 20% is strategic/design reasoning Claude does by looking at the captured screenshots — above-the-fold clarity, positioning, information architecture, visual hierarchy, brand voice distinctiveness, topical authority gaps.

---

Why AEO matters

Most audits cover SEO. This one equally weights AEO — Answer-Engine Optimization — the signals that