Quick Reference
Minimum Requirements:- ✅ 2,000+ words
- ✅ Primary keyword density 1-2%
- ✅ Keyword in H1, first 100 words, 2-3 H2s
- ✅ 3-5 internal links
- ✅ 2-3 external links
- ✅ Meta title 50-60 chars
- ✅ Meta description 150-160 chars
- ✅ 8th-10th grade reading level
Content Checklist
Length & Depth
- Minimum 2,000 words (2,500-3,000+ preferred)
- Exceeds or matches top 10 SERP average
- Covers topic comprehensively
- Answers all “People Also Ask” questions
- Provides unique value vs competitors
Keywords
- Primary keyword identified
- Keyword density 1-2% (not stuffed)
- Keyword in H1 title
- Keyword in first 100 words
- Keyword in 2-3 H2 headings
- Keyword in meta title
- Keyword in meta description
- Keyword in URL slug
- 5-10 LSI keywords included
- Semantic variations used naturally
Internal Links
- 3-5 internal links minimum
- Descriptive anchor text (not “click here”)
- Links to relevant content
- Links to pillar pages
- At least one link in first 300 words
- All links working (no 404s)
- Links open in same tab
External Links
- 2-3 external authority links
- All statistics cited with sources
- Links to credible sources (.gov, .edu, industry leaders)
- No broken external links
- External links open in new tab
- No links to direct competitors
Content Quality
- Factually accurate
- Statistics current and cited
- Examples are specific and real
- Actionable advice provided
- No spelling errors
- No grammar errors
- Brand voice maintained
- Passes plagiarism check
On-Page SEO Checklist
Title (H1)
- Only one H1 per page
- Includes primary keyword
- 60 characters or less
- Compelling and clickable
- Unique (not duplicate on site)
Meta Title
- 50-60 characters (required)
- Includes primary keyword
- Keyword near beginning
- Includes year if freshness important
- Unique across site
- Compelling (includes benefit/number/power word)
[Keyword]: [Benefit/Number] (Year)
Meta Description
- 150-160 characters (required)
- Includes primary keyword
- Clear value proposition
- Includes call-to-action
- Unique across site
- Actionable language
[What they'll learn]. [Supporting detail]. [CTA]
URL Slug
- Includes primary keyword
- Short and descriptive
- Lowercase letters
- Hyphens (not underscores)
- No stop words (a, an, the, for)
- Permanent (won’t change)
/content-marketing-strategies
Bad: /the-ultimate-guide-to-content-marketing-strategies-2026
Heading Structure
- Only one H1 (title)
- H2 headings every 300-400 words
- H3 headings for subsections
- Proper hierarchy (never skip levels)
- Descriptive headings (not “Introduction”)
- 2-3 H2s include keyword variations
- Total: 5-12 headings
Images
- Featured image at top
- At least 1 image per 500 words
- All images have descriptive alt text
- Alt text includes keyword (naturally)
- Images compressed (less than 200KB each)
- Images responsive on mobile
- File names descriptive (keyword-related.jpg)
- Proper image format (JPG for photos, PNG for graphics)
[Keyword] [what image shows]
Schema Markup
- Article schema implemented
- FAQ schema (if applicable)
- How-to schema (if applicable)
- Breadcrumb schema
- Author schema
- Organization schema
Readability Checklist
Reading Level
- 8th-10th grade Flesch-Kincaid
- Flesch Reading Ease 60-70
- Simple words over complex
- Technical terms defined
- Jargon avoided or explained
Sentences
- Average length 15-20 words
- Maximum 30 words
- Varied sentence lengths
- Active voice preferred
- Passive voice less than 10%
Paragraphs
- 2-4 sentences per paragraph
- Maximum 5 sentences
- One idea per paragraph
- Logical flow between paragraphs
- Transition words used
Formatting
- Bullet points for lists
- Numbered lists for steps/rankings
- Bold for emphasis (used sparingly)
- Tables for comparisons
- Adequate white space
- Short paragraphs
- Scannable structure
Structure Checklist
Introduction (100-150 words)
- Hook in first sentence
- Problem/pain point identified
- Promise (what they’ll learn)
- Primary keyword in first 100 words
- Engaging and clear
Body
- Logical section flow
- Each section builds on previous
- Transitions between sections
- Examples in every major section
- Data/statistics to support claims
- Subsections for complex topics
- Answers search intent completely
Conclusion (100-200 words)
- Summarizes key points
- Clear call-to-action
- Next steps provided
- Reinforces main benefit
- Engaging close
Technical SEO Checklist
Performance
- Page loads in less than 3 seconds
- Images optimized/compressed
- No render-blocking resources
- CSS/JS minified
- Lazy loading implemented
Mobile
- Mobile-responsive design
- Text readable without zooming
- Buttons/links easy to tap
- No horizontal scrolling
- Fast mobile load time
Indexing
- No noindex tag (unless intentional)
- Robots.txt allows crawling
- Canonical URL set correctly
- Sitemap updated
- No duplicate content issues
Links
- All internal links working
- All external links working
- No redirect chains
- HTTPS (secure) links only
- Links use descriptive anchors
SERP Features Checklist
Featured Snippet
- Concise answer in first 100 words
- Clear definition/answer format
- 40-60 word summary
- Uses paragraph or list format
- Targets question-based queries
People Also Ask
- FAQ section added
- 5-10 related questions answered
- Concise answers (2-3 sentences each)
- FAQ schema markup added
- Questions from SERP research included
Rich Snippets
- Schema markup implemented
- Star ratings (if applicable)
- Author information
- Published/updated dates
- Breadcrumbs
Video Results
- Video embedded (if applicable)
- Video schema markup
- Descriptive video title
- Transcript included
Image Pack
- High-quality images
- Descriptive file names
- Comprehensive alt text
- Proper image dimensions
- Images unique/original
Competitive Analysis Checklist
Before Writing
- Analyzed top 10 SERP results
- Identified content gaps
- Noted average word count
- Reviewed content types
- Checked SERP features present
- Studied competitor structure
Differentiation
- Unique angle or perspective
- Better/more examples than competitors
- More current data
- Superior formatting
- Additional value (templates, tools, etc.)
- Better visual content
Competitive Advantage
- Exceeds average competitor word count
- More comprehensive coverage
- Better readability score
- More internal links
- Better visual content
- Unique insights or data
Pre-Publishing Checklist
Final Review
- Read entire article aloud
- Check for flow and clarity
- Verify all facts and statistics
- Test all links (internal and external)
- Preview on mobile device
- Check image loading
- Verify meta elements display correctly
- Confirm proper formatting
Tools Check
- Run
/optimizecommand - Content Analyzer score 80+
- SEO score 80+
- Address all CRITICAL issues
- Address all HIGH priority issues
- Review MEDIUM issues
Publishing Readiness
- All CRITICAL issues resolved
- All HIGH priority issues resolved
- Content score 80+
- Pre-publishing checklist 100% complete
- Final approval obtained (if required)
Post-Publishing Checklist
Immediate (Day 1)
- Submit URL to Google Search Console
- Share on social media
- Send to email list (if applicable)
- Internal team notification
- Add to content calendar
Week 1
- Check for crawl errors in GSC
- Verify page indexed by Google
- Monitor initial impressions/clicks
- Check for broken links
- Review user engagement metrics
Month 1
- Track keyword rankings
- Monitor organic traffic
- Analyze user behavior (GA4)
- Check for ranking improvements
- Identify optimization opportunities
Quarterly
- Update statistics and examples
- Refresh outdated content
- Add new sections if needed
- Check competitor updates
- Re-optimize if rankings dropped
Scoring Guide
Content Quality Score
90-100: Excellent - Publish immediately- Comprehensive coverage
- Perfect SEO optimization
- Highly readable
- Unique value
- Publication-ready
- Good coverage
- Strong SEO
- Readable
- Some unique value
- Small improvements needed
- Adequate coverage
- Basic SEO
- Somewhat readable
- Limited uniqueness
- Significant improvements needed
- Incomplete coverage
- Poor SEO
- Hard to read
- No unique value
- Substantial rewrite needed
Priority Levels
CRITICAL: Must fix before publishing- Missing meta title/description
- No primary keyword
- less than 1,500 words
- Broken links
- Keyword stuffing
- Plagiarized content
- Low keyword density
- Poor heading structure
- Few internal links
- Low readability
- Missing images
- Generic content
- Could add more examples
- Could improve formatting
- Could add more LSI keywords
- Could strengthen conclusion
- Style preferences
- Minor tweaks
- Future enhancements
Common Issues & Fixes
Issue: Low Content Score
Fix:- Run Content Analyzer
- Check which dimension is low
- Focus on lowest score first
- Use specific fixes for that dimension
- Re-test until score >80
Issue: Keyword Density Too High
Fix:- Check current density (should be 1-2%)
- Replace keyword mentions with:
- Synonyms
- “It”, “this”, “that”
- Related terms
- Focus on natural language
- Re-check with Keyword Analyzer
Issue: Poor Readability
Fix:- Shorten sentences (break at commas)
- Replace complex words with simple ones
- Add more paragraph breaks
- Use more lists
- Add more subheadings
- Use transition words
Issue: Low SEO Score
Fix:- Run SEO Optimizer
- Check all on-page elements:
- Meta title/description
- Keyword placement
- Internal links
- Heading structure
- Fix issues in priority order
- Re-test until score >80
Issue: Missing Internal Links
Fix:- Review
context/internal-links-map.md - Identify 3-5 relevant pages
- Find natural places to link
- Use descriptive anchor text
- Add at least one link in first 300 words
Tools Reference
Commands
/optimize [file]: Complete optimization check/scrub [file]: Remove AI patterns
Agents
- Content Analyzer: 5-module comprehensive analysis
- SEO Optimizer: On-page SEO scoring
- Meta Creator: Meta title/description options
- Internal Linker: Link suggestions
- Keyword Mapper: Keyword distribution analysis
- Editor: Readability and humanity improvements
Python Modules
seo_quality_rater.py: 0-100 SEO scorereadability_scorer.py: Readability metricskeyword_analyzer.py: Keyword densitycontent_scorer.py: 5-dimension scoringsearch_intent_analyzer.py: Intent classification
Quick Start
For every article:- ✅ Use
/research-serp [keyword]for requirements - ✅ Write 2,000+ words following brief
- ✅ Run
/optimize [file]before publishing - ✅ Address CRITICAL and HIGH issues
- ✅ Verify checklist 100% complete
- ✅ Publish when score >80
- Content Score: 80+
- SEO Score: 80+
- All CRITICAL issues: 0
- Pre-publishing checklist: 100%