seo-audit

Installation

$npx skills add coopersimson96/ai-content-system --skill seo-audit

Summary

This skill enables an agent to crawl up to 500 pages, detect business type, and delegate to six specialized SEO subagents (technical, content, schema, sitemap, performance, visual) to generate a prioritized action plan and health score. Invoke when a user requests a full site audit, SEO check, or website health assessment.

SKILL.MD

Full Website SEO Audit

Process

  1. Fetch homepage — use scripts/fetch_page.py to retrieve HTML
  2. Detect business type — analyze homepage signals per seo orchestrator
  3. Crawl site — follow internal links up to 500 pages, respect robots.txt
  4. Delegate to subagents (if available, otherwise run inline sequentially):
    • seo-technical — robots.txt, sitemaps, canonicals, Core Web Vitals, security headers
    • seo-content — E-E-A-T, readability, thin content, AI citation readiness
    • seo-schema — detection, validation, generation recommendations
    • seo-sitemap — structure analysis, quality gates, missing pages
    • seo-performance — LCP, INP, CLS measurements
    • seo-visual — screenshots, mobile testing, above-fold analysis
  5. Score — aggregate into SEO Health Score (0-100)
  6. Report — generate prioritized action plan

Crawl Configuration

Max pages: 500
Respect robots.txt: Yes
Follow redirects: Yes (max 3 hops)
Timeout per page: 30 seconds
Concurrent requests: 5
Delay between requests: 1 second

Output Files

  • FULL-AUDIT-REPORT.md — Comprehensive findings
  • ACTION-PLAN.md — Prioritized recommendations (Critical → High → Medium → Low)
  • screenshots/ — Desktop + mobile captures (if Playwright available)

Scoring Weights

CategoryWeight
Technical SEO25%
Content Quality25%
On-Page SEO20%
Schema / Structured Data10%
Performance (CWV)10%
Images5%
AI Search Readiness5%

Report Structure

Executive Summary

  • Overall SEO Health Score (0-100)
  • Business type detected
  • Top 5 critical issues
  • Top 5 quick wins

Technical SEO

  • Crawlability issues
  • Indexability problems
  • Security concerns
  • Core Web Vitals status

Content Quality

  • E-E-A-T assessment
  • Thin content pages
  • Duplicate content issues
  • Readability scores

On-Page SEO

  • Title tag issues
  • Meta description problems
  • Heading structure
  • Internal linking gaps

Schema & Structured Data

  • Current implementation
  • Validation errors
  • Missing opportunities

Performance

  • LCP, INP, CLS scores
  • Resource optimization needs
  • Third-party script impact

Images

  • Missing alt text
  • Oversized images
  • Format recommendations

AI Search Readiness

  • Citability score
  • Structural improvements
  • Authority signals

Priority Definitions

  • Critical: Blocks indexing or causes penalties (fix immediately)
  • High: Significantly impacts rankings (fix within 1 week)
  • Medium: Optimization opportunity (fix within 1 month)
  • Low: Nice to have (backlog)