seo-audit

---
name: seo-audit
description: Perform comprehensive SEO audits on Next.js/React codebases using static analysis. Use when analyzing pages for SEO issues, checking metadata, verifying structured data, auditing Core Web Vitals code patterns, or reviewing technical SEO elements (robots.txt, sitemap, canonical URLs). Covers technical SEO, on-page SEO, and performance optimization.
---

# SEO Audit

Static analysis for SEO issues in Next.js/React projects. Includes scoring (0-100) with letter grades.

## Quick Start

Run automated audit:
```bash
python .claude/skills/seo-audit/scripts/audit.py --path .
```

Output options: `--format json` for machine-readable, `--output report.txt` to save.

## Rating System

The audit produces a score from 0-100 with the following breakdown:

| Category | Max Points | What's Checked |
|----------|------------|----------------|
| Technical SEO | 30 | robots.txt, sitemap, canonicals |
| On-Page SEO | 30 | metadata, headings, images |
| Structured Data | 15 | JSON-LD schemas |
| Social/Sharing | 10 | Open Graph, Twitter Cards |
| Performance | 15 | Image optimization, script loading |

**Grades**: A+ (95+), A (90-94), A- (85-89), B+ (80-84), B (75-79), B- (70-74), C+ (65-69), C (60-64), C- (55-59), D (50-54), F (<50)

**Deductions**: Critical issues (-15), Warnings (-5), Info (-2)

## Audit Workflow

### 1. Run Automated Scan
Execute `scripts/audit.py` to identify common issues automatically.

### 2. Review Critical Areas
Based on scan results, manually review:

| Area | Reference | Priority |
|------|-----------|----------|
| Technical SEO | `references/technical-seo.md` | robots.txt, sitemap, canonicals, structured data |
| On-Page SEO | `references/on-page-seo.md` | titles, descriptions, headings, images |
| Performance | `references/core-web-vitals.md` | LCP, CLS, INP code patterns |

### 3. Generate Report
Summarize findings by severity (critical/warning/info) with actionable fixes.

## Common Checks

**Technical**: robots.txt blocks, missing sitemap, no canonical URLs, missing structured data
**On-Page**: empty/duplicate titles, missing meta descriptions, multiple h1s, images without alt
**Performance**: images without priority/dimensions, fonts without swap, render-blocking scripts

## References

- `references/technical-seo.md` - Crawlability, indexing, structured data patterns
- `references/on-page-seo.md` - Metadata, headings, images, content checklist
- `references/core-web-vitals.md` - LCP, CLS, INP static analysis patterns

## Scripts

- `scripts/audit.py` - Automated SEO audit with JSON/text output
- `scripts/test_audit.py` - Test suite for audit script