seo-review

name	seo-review
description	Perform SEO audit on documentation or content pages. Use before publishing, when optimizing underperforming pages, or during content audits.

SEO Review

Audit content pages for search visibility and ranking potential.

Audit Checklist

Title Tag (50-60 chars)

• Primary keyword in first half
• Contains compelling hook/benefit
• Not truncated in search results

Meta Description (150-160 chars)

• Starts with action word (Learn, Discover, Understand)
• Contains primary keyword
• Promises specific value

Keyword Placement

• In title and meta description
• In first 100 words
• In at least one H2 heading
• No stuffing (max 3-4 per 1000 words)

Content Structure

• Opens with question hook
• Code/example in first 200 words (for technical content)
• Short paragraphs (2-4 sentences)
• 1,500+ words for comprehensive topics
• Key terms bolded on first mention

Featured Snippet Optimization

Query Type	Winning Format
"What is X"	40-60 word definition paragraph
"How to X"	Numbered steps
"X vs Y"	Comparison table
"Types of X"	Bullet list

Internal Linking

• 3-5 related page links in body
• Descriptive anchor text (no "click here")
• Related content section at end
• No orphan pages

Technical SEO

• Single H1 per page (the title)
• URL slug contains keyword, uses hyphens, lowercase
• Page linked from at least one other page

Scoring

Category	Points
Title Tag	/4
Meta Description	/4
Keyword Placement	/5
Content Structure	/6
Featured Snippets	/4
Internal Linking	/4
Technical SEO	/3
Total	/30

Score	Status
27-30	✅ Ready to publish
23-26	⚠️ Minor fixes needed
17-22	⚠️ Several improvements needed
<17	❌ Significant work required

Output Format

# SEO Audit: [Page Name]

**Score:** X/30 (X%)
**Status:** ✅/⚠️/❌

## Issues

### High Priority
- [Issue]: Current → Recommended

### Medium Priority
- [Issue]: Recommendation

### Low Priority
- [Issue]: Nice to have

## Quick Wins
- [Immediate fixes]