Install this Claude Code skill.
Name: SEO Audit and Fix
Save to: ~/.claude/skills/seo-audit-and-fix.md

---
---
name: seo-audit-and-fix
description: Audit and fix SEO issues — meta tags, OG, structured data, sitemap, Core Web Vitals. Use when user says "audit SEO", "fix my SEO", "improve search ranking", or "add meta tags".
---

Perform a comprehensive SEO audit and generate fixes.

## Instructions

### Step 1: Technical SEO Audit
Check the project for these files and configurations:

**Required files:**
- [ ] `robots.txt` — exists, allows indexing, points to sitemap
- [ ] `sitemap.xml` — exists, includes all public pages, proper lastmod dates
- [ ] Favicon — multiple sizes (16, 32, 180, 192, 512)
- [ ] `manifest.json` — for PWA/mobile

**Meta tags on every page:**
```html
<title>Primary Keyword - Brand Name</title>  <!-- 50-60 chars -->
<meta name="description" content="..." />     <!-- 150-160 chars -->
<link rel="canonical" href="..." />           <!-- Prevent duplicates -->
<meta name="robots" content="index, follow" />
```

**Open Graph (social sharing):**
```html
<meta property="og:title" content="..." />
<meta property="og:description" content="..." />
<meta property="og:image" content="..." />     <!-- 1200x630px -->
<meta property="og:url" content="..." />
<meta property="og:type" content="website" />
<meta property="og:site_name" content="..." />
```

**Twitter Card:**
```html
<meta name="twitter:card" content="summary_large_image" />
<meta name="twitter:title" content="..." />
<meta name="twitter:description" content="..." />
<meta name="twitter:image" content="..." />
```

### Step 2: Structured Data (JSON-LD)
Add schema.org markup based on page type:

- **Homepage**: Organization or WebSite schema
- **Blog posts**: BlogPosting or Article
- **Products**: Product with offers, reviews
- **FAQ pages**: FAQPage
- **Local business**: LocalBusiness

Validate with Google's Rich Results Test.

### Step 3: Performance (Core Web Vitals)
Check and optimize:
- **LCP** (Largest Contentful Paint): < 2.5s
  - Optimize images (WebP, proper sizing, lazy loading)
  - Preload critical resources
  - Server-side rendering for above-fold content
- **FID/INP** (Interaction to Next Paint): < 200ms
  - Minimize JavaScript bundle size
  - Code split routes
  - Defer non-critical scripts
- **CLS** (Cumulative Layout Shift): < 0.1
  - Set explicit width/height on images
  - Reserve space for dynamic content
  - Avoid inserting content above existing content

### Step 4: Content Optimization
For each important page:
- H1 tag exists and contains primary keyword (one per page)
- H2-H6 hierarchy is logical
- Internal links to related pages
- Image alt text is descriptive
- URL slug is short and keyword-rich
- Content is at least 300 words for ranking pages

### Step 5: Generate Report
Output a table:

| Check | Status | Fix Required |
|-------|--------|-------------|
| robots.txt | ... | ... |
| sitemap.xml | ... | ... |
| Meta titles | ... | ... |
| Meta descriptions | ... | ... |
| OG tags | ... | ... |
| JSON-LD | ... | ... |
| Image optimization | ... | ... |
| Core Web Vitals | ... | ... |

Then generate the code fixes for each issue found.