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 "summary_large_image"
• •✅ 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.NEXT_PUBLIC_BASE_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