SEO Audit Skill
Deliver a thorough, actionable SEO audit for any URL or domain. Output should be immediately useful — not generic advice.
Workflow
1. Gather Target
Ask for the URL if not provided. Optionally ask for: target keywords, competitors to benchmark against, and priority pages.
2. Fetch & Analyze Pages
Use web_fetch to retrieve page content. Analyze:
- Title tag: Present? Length (50–60 chars ideal)? Contains primary keyword?
- Meta description: Present? Length (150–160 chars ideal)? Compelling CTA?
- H1/H2/H3 structure: Single H1? Keyword-rich headings? Logical hierarchy?
- Content quality: Word count, keyword density (1–2%), readability, duplicate content signals
- Internal linking: Anchor text quality, orphan pages, link depth
- Image alt text: Present on all images?
- URL structure: Clean, keyword-rich, no excessive parameters?
- Schema markup: Present? Appropriate type?
3. Technical Signals (infer from page source)
- Page load indicators (inline CSS vs external, render-blocking scripts)
- Mobile viewport meta tag
- Canonical tags
- robots meta tag
- HTTPS
- Structured data (JSON-LD)
4. Keyword Analysis
Use web_search to:
- Identify what the page currently ranks for (search
site:domain.com) - Find keyword gaps vs competitors
- Suggest 5–10 target keywords with estimated intent (informational/transactional/navigational)
5. Competitor Benchmarking (if competitors provided)
Fetch top competitor pages for same keywords. Compare: title structure, content length, heading strategy, backlink signals (visible in SERPs).
6. Generate Report
Use the report template in references/report-template.md. Sections:
- Executive Summary (3–5 bullet critical issues)
- Score card (0–100 across 5 dimensions)
- On-Page Analysis
- Technical SEO
- Keyword Opportunities
- Quick Wins (fix in <1 hour)
- Long-Term Roadmap
7. Run the Audit Script (optional, for bulk analysis)
python3 scripts/seo_audit.py --url <URL> [--competitors url1,url2] [--keywords kw1,kw2]
See references/scoring-rubric.md for how scores are calculated.
See references/checklist.md for the full 50-point audit checklist.