SEO Verification Skill

Purpose

Validate and audit all SEO metadata across the PM Philosophy Map to ensure optimal search engine visibility and social media sharing.

When to Use This Skill

• User asks to "verify SEO"
• User wants to "check metadata" or "audit SEO"
• User requests to "validate OpenGraph tags"
• User asks to "check for SEO issues"
• Before production deployments

What to Check

1. Meta Tags

Files to verify:

• app/layout.tsx - Root metadata
• app/episodes/[slug]/layout.tsx - Episode-specific metadata
• app/results/page.tsx - Results page metadata
• app/quiz/page.tsx - Quiz page metadata
• app/explore/page.tsx - Explore page metadata

Validate:

• ✅ Title tags exist and are descriptive (50-60 chars optimal)
• ✅ Meta descriptions exist and compelling (150-160 chars optimal)
• ✅ Keywords are relevant and not stuffed
• ✅ Canonical URLs use correct domain (lenny.productbuilder.net)
• ✅ No localhost references in production

2. OpenGraph Metadata

Check all pages for:

• ✅ og:title - Present and descriptive
• ✅ og:description - Present and compelling
• ✅ og:image - Valid path, proper dimensions (1200x630)
• ✅ og:url - Uses correct domain
• ✅ og:type - Appropriate (website/article)
• ✅ og:site_name - Consistent branding

3. Twitter Card Metadata

Validate:

• ✅ twitter:card - Set to "summarylargeimage"
• ✅ twitter:title - Optimized for Twitter
• ✅ twitter:description - Under 200 chars
• ✅ twitter:image - Valid OG image path
• ✅ twitter:creator - Set to @lennysan

4. Domain References

Search codebase for:

• ❌ localhost:3000 - Should use lenny.productbuilder.net
• ❌ http://localhost - Should use production domain
• ❌ Hardcoded old domains (pmphilosophy.com)
• ✅ All URLs use process.env.NEXTPUBLICBASE_URL or correct fallback

5. Sitemap & Robots.txt

Verify:

• ✅ app/sitemap.ts generates valid XML
• ✅ All pages included (home, quiz, explore, results, 303 episodes)
• ✅ Proper lastModified dates
• ✅ Correct priority values (1.0 for home, 0.9 for quiz, etc.)
• ✅ No localhost URLs in sitemap

6. Image Assets

Check:

• ✅ /public/og-image.png exists (1200x630)
• ✅ Episode OG images in /public/og/[slug].png
• ✅ Favicon /public/favicon.svg exists
• ✅ All images optimized for web

Verification Process

Step 1: Scan Metadata Files

# Read all layout and page files
Read app/layout.tsx
Read app/episodes/[slug]/layout.tsx
# Check for missing or malformed metadata

Step 2: Search for Domain Issues

# Find localhost references
Grep -r "localhost" in app/, lib/, components/
# Find hardcoded domains
Grep -r "pmphilosophy.com|http://" in codebase

Step 3: Validate OG Images

# Check if OG images exist
ls public/og-image.png
ls public/og/*.png (episode images)
# Verify dimensions with identify or similar

Step 4: Test Sitemap Generation

# Build and check sitemap
npm run build
curl http://localhost:3000/sitemap.xml
# Verify no localhost URLs in output

Step 5: Generate Report

Output format:

# SEO Audit Report - [Date]

## ✅ Passed Checks
- Root metadata properly configured
- OpenGraph tags present on all pages
- Twitter cards configured correctly

## ⚠️ Issues Found
1. **Episode layouts using hardcoded domain**: app/episodes/[slug]/layout.tsx:23
   - Fix: Use process.env.NEXT_PUBLIC_BASE_URL
2. **Missing OG image**: public/og/new-episode.png
   - Fix: Generate OG image for new episode

## 📋 Recommendations
- Add structured data (JSON-LD) for episodes
- Consider adding breadcrumb navigation metadata
- Optimize meta descriptions for better CTR

Quick Commands

Check for localhost references:

grep -r "localhost" app/ lib/ components/ --include="*.tsx" --include="*.ts"

Validate metadata exists:

grep -r "export.*metadata\|generateMetadata" app/ --include="*.tsx"

List OG images:

ls -lh public/og/ | wc -l  # Count episode OG images

Success Criteria

• ✅ All pages have complete metadata
• ✅ No localhost references in production code
• ✅ All OG images exist and are properly sized
• ✅ Sitemap includes all 303 episodes + static pages
• ✅ Canonical URLs use correct domain
• ✅ Twitter/OG preview cards render correctly

Related Skills

• verify-sitemap - Deep dive into sitemap validation
• update-og-images - Batch generate/update OG images