# SEO Audit

> Audit tool for reviewing and diagnosing SEO issues, including technical SEO, on-page optimization, content quality (E-E-A-T), and AEO/GEO readiness. Use when the user asks to audit a website's SEO, diagnose organic search problems, review technical SEO health, optimize on-page elements, assess content quality for search, check Core Web Vitals, improve search visibility, or create an SEO action plan. Also triggers on 'SEO audit', 'technical SEO', 'on-page SEO', 'content SEO', 'search optimization', 'organic traffic', 'crawlability', 'indexation issues', 'Core Web Vitals', 'E-E-A-T', 'AEO', 'GEO', 'answer engine optimization', 'generative engine optimization'.

- Skill: `a-lezin/seo-audit` (Agent Skill, multi-file: 6 files)
- Install (CLI): `npx skillmds@latest add a-lezin/seo-audit`
- Raw SKILL.md: https://api.skillmd.com/api/skills/a-lezin/seo-audit/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Marketing & Growth
- Author: a-lezin (https://skillmd.com/u/a-lezin)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/a-lezin/seo-audit

---


# SEO Audit

Act as an SEO expert identifying issues and delivering actionable recommendations to enhance organic search visibility.

## Initial Assessment

Read `.claude/product-marketing-context.md` if available — use it for understanding target audience, key messaging, and competitors to contextualize SEO recommendations.

Gather from user:
- Site URL and site type
- Primary SEO business objectives
- Current organic performance metrics and known concerns
- Audit scope (full site vs specific pages; technical vs content focus)
- Available data (GSC exports, analytics, PageSpeed reports)

## Data Collection (Pre-Audit)

Use publicly available tools and user-provided data.

### Step 1: Core Web Vitals + PageSpeed

- Fetch PageSpeed Insights via WebFetch: `https://pagespeed.web.dev/analysis?url=SITE_URL`
- If the user provides a `GOOGLE_API_KEY`, use the PSI API directly for structured data
- Check both mobile and desktop
- Record LCP, INP, CLS values and Lighthouse scores

### Step 2: Keyword & Search Data

- Ask the user for GSC export data (keyword positions, impressions, CTR) if available
- If no GSC data: use `site:` operator via WebSearch to assess indexation scope
- Identify high-impression/low-CTR pages (title/description optimization targets)
- Identify keywords in positions 4-10 (quick-win optimization targets)

### Step 3: Analytics Data

- Ask the user for traffic data if available (GA4 export, Plausible, etc.)
- Use traffic source data in Priority 5 (Authority & Links)
- Use engagement metrics in the executive summary
- If no analytics: proceed with publicly available data

### Step 4: Link Building & AI Visibility Quick Assessment

No external tools needed — use WebFetch and web search:

- **AI crawler access**: Fetch `robots.txt` via WebFetch, check that OAI-SearchBot, PerplexityBot, GPTBot, Google-Extended, ClaudeBot are NOT blocked
- **Schema.org completeness**: Fetch homepage and key pages, verify Organization, FAQPage, Article schemas are present
- **Unlinked brand mentions**: Search Google for `"brand name" -site:own-domain` to find mention opportunities
- **Internal linking health**: Compare sitemap URLs vs actual internal links on pages — look for orphan pages
- **Directory presence**: Check if site is listed on Product Hunt, G2, AlternativeTo, Capterra

Use findings in **Priority 6 (Link Building & AI Visibility)** and reference [references/link-building-checklist.md](references/link-building-checklist.md) for full checklist.

## Audit Priority Framework

Execute in this order:

1. **Crawlability & Indexation** — robots.txt, XML sitemap, site architecture (important pages within 3 clicks), crawl budget for large sites
2. **Technical Foundations** — Core Web Vitals (LCP <2.5s, INP <200ms, CLS <0.1), TTFB, image optimization, JS execution, mobile responsiveness, HTTPS
3. **On-Page Optimization** — title tags (50-60 chars), meta descriptions (150-160 chars), heading hierarchy (single H1, logical H2/H3), keyword integration, internal linking
4. **Content Quality (E-E-A-T)** — experience demonstration, expertise credentials, authority recognition, trustworthiness signals
5. **Authority & Links** — backlink profile, link distribution, anchor text quality
6. **Link Building & AI Visibility** — backlink quick-win opportunities, AI crawler access, Schema.org completeness, AEO/GEO readiness score

## Indexation Verification

- `site:` operator checks and Search Console coverage reports
- Noindex tags, canonical direction, redirect chain assessment
- Self-referencing canonicals and protocol/www consistency

## Site-Type Specific Issues

- **SaaS**: Thin product pages, blog-product integration gaps
- **E-commerce**: Category page depth, duplicate descriptions, faceted navigation
- **Content Sites**: Outdated content, keyword cannibalization
- **Local**: NAP consistency, Google Business Profile optimization

## Report Structure

1. Executive summary with top 3-5 priorities
2. Technical findings with severity ratings
3. On-page findings with specific fix recommendations
4. Content assessment against E-E-A-T criteria
5. Link building assessment with quick-win opportunities
6. AI visibility readiness score (AEO/GEO checklist)
7. Actionable roadmap organized by urgency (critical / high / medium / low)

## Examples

Example 1: Full site audit
User says: "Run a full SEO audit on example.com"
Actions:
1. Read product-marketing-context.md for positioning context
2. Fetch PageSpeed Insights for mobile + desktop
3. Fetch and analyze robots.txt, sitemap, key pages via WebFetch
4. Deliver full report with 6 priority sections and actionable roadmap

Example 2: On-page focus
User says: "Check SEO on the pricing page"
Actions:
1. Fetch PageSpeed Insights for the specific URL
2. Fetch page content, analyze title, meta, headings, keyword usage
3. Deliver on-page findings with specific fix recommendations

Example 3: AEO/GEO readiness
User says: "Is my content ready for AI search?"
Actions:
1. Analyze content structure against AEO/GEO patterns from references/aeo-geo-patterns.md
2. Check for definition blocks, FAQ schema, statistic citations, expert quotes
3. Deliver content optimization recommendations for AI engine visibility

## Troubleshooting

**CWV field data unavailable**: Sites with low traffic may not have field data in CrUX. Rely on lab data (PSI/Lighthouse) instead — note this limitation in the report.

**`site:` operator shows 0 results**: The site may not be indexed yet or may be blocking crawlers. Check robots.txt and meta robots tags first.

## References

- **AEO/GEO content patterns**: See [references/aeo-geo-patterns.md](references/aeo-geo-patterns.md) — use when optimizing content for featured snippets, AI Overviews, voice search, or AI assistant citation. Includes AI Citation Optimization data, platform-specific strategies, Schema priority, and Reddit GEO tactics
- **AI writing detection**: See [references/ai-writing-detection.md](references/ai-writing-detection.md) — use when reviewing content for AI-generated text markers
- **Link building checklist**: See [references/link-building-checklist.md](references/link-building-checklist.md) — backlink profile health, quick-win opportunities, HARO/media outreach, linkable assets, internal linking, outreach tools
- **pSEO quality checklist**: See [references/pseo-quality-checklist.md](references/pseo-quality-checklist.md) — per-page requirements, batch launch rules, technical requirements, content differentiation strategies for programmatic SEO pages

## Data Tools

- **WebFetch** (primary): For robots.txt, sitemap, page content, Schema.org validation, PageSpeed Insights
- **WebSearch**: For `site:` indexation checks, competitor analysis, unlinked brand mentions
- **User-provided data** (supplementary): GSC exports, GA4 data, Screaming Frog crawl reports