Best Practices

​

Before Writing

​

1. Research First

• Understand what Google wants
• Identify content gaps vs competitors
• Determine optimal word count
• Find related keywords to target
• Create comprehensive outline

/research content marketing strategies
# Review research/brief-content-marketing-strategies-YYYY-MM-DD.md
/write content marketing strategies

​

2. Review Context Files

• brand-voice.md: Voice pillars, tone guidelines
• writing-examples.md: Examples of your best work
• target-keywords.md: Keyword clusters and priorities
• internal-links-map.md: Pages to link to

​

3. Check Keyword Strategy

• Primary keyword identified
• Search intent clear
• Related LSI keywords listed
• Topic cluster mapped

• What is user’s search intent?
• What questions are they asking?
• What problem are they solving?
• Where do they go next?

​

4. Plan Internal Links

• Identify 3-5 relevant pages
• Note natural places to link
• Plan anchor text
• Map user journey

​

During Writing

​

1. Follow the Research Brief

• Follow recommended structure
• Hit target word count
• Cover all identified gaps
• Answer “People Also Ask” questions
• Target SERP features

​

2. Integrate Keywords Naturally

• In H1 (naturally, not forced)
• In first 100 words
• In 2-3 H2 headings
• In meta title and description
• Throughout body (1-2% density)

• Sprinkle 5-10 related terms
• Use semantic variations
• Don’t force them

​

3. Add Value Beyond Competitors

• Actionable advice (not just information)
• Specific examples (not generic statements)
• Real data and statistics
• Unique insights from your experience
• Visual elements (images, tables, lists)

​

4. Use Examples Liberally

• Real brand names and companies
• Specific numbers and data
• Case studies and success stories
• Screenshots and visuals
• Step-by-step walkthroughs

​

5. Cite All Sources

• Link to original source
• Use credible sources (.gov, .edu, industry leaders)
• Include year of data
• Verify accuracy

​

After Writing

​

1. Review Agent Output

• Check SEO score (target 80+)
• Address CRITICAL issues first
• Review keyword placement
• Fix structural issues

• Choose best meta title/description
• Verify character counts
• Test for clarity and CTR appeal

• Review 3-5 link suggestions
• Verify relevance
• Check anchor text
• Ensure natural placement

• Check density (should be 1-2%)
• Review distribution map
• Identify gaps
• Fix keyword stuffing

​

2. Make Improvements

• Missing meta elements
• Keyword density problems
• Heading structure issues
• Missing internal links
• Readability problems

1. Read all agent reports
2. Make a list of improvements
3. Edit article
4. Re-run /optimize to verify

​

3. Run /optimize

/optimize drafts/your-article-YYYY-MM-DD.md

• Complete SEO audit
• All elements validated
• Final recommendations
• Publishing readiness score

• Content score: 80+
• SEO score: 80+
• All CRITICAL issues: 0
• All HIGH issues: addressed

​

4. Self-Edit

• Is it clear and easy to follow?
• Does it answer their question completely?
• Would you keep reading?
• Is there fluff you can cut?
• Are examples specific and helpful?

• Does it sound natural?
• Are sentences too long?
• Does it flow well?
• Any awkward phrasing?

• Can you understand it by reading headings only?
• Are paragraphs short (2-4 sentences)?
• Enough lists and formatting?
• Clear visual hierarchy?

​

5. Verify Quality Checklist

• 2,000+ words
• Unique value
• Accurate and current
• Actionable advice
• Brand voice maintained

• Keyword density 1-2%
• Keyword placement correct
• 3-5 internal links
• 2-3 external links
• Meta title 50-60 chars
• Meta description 150-160 chars
• Heading hierarchy correct
• URL slug optimized

• 8th-10th grade level
• Sentences 15-20 words average
• Paragraphs 2-4 sentences
• Subheadings every 300-400 words
• Lists for scannability

• Compelling introduction
• Logical flow
• Clear conclusion with CTA
• Examples throughout

​

Workflow Optimization

​

For Rewrites

​

1. Analyze First

/analyze-existing https://yoursite.com/blog/marketing-guide

• Content health score (0-100)
• What’s outdated
• What’s missing vs competitors
• Update priority and scope
• Quick wins vs major rewrite

​

2. Determine Strategy

• Update statistics (current year)
• Refresh 1-2 examples
• Minor SEO improvements
• Est. time: 30 mins

• Update all statistics
• Add 300-500 words
• Refresh 3-5 examples
• Improve SEO
• Est. time: 2 hours

• Rewrite introduction and conclusion
• Add 500-1000 words
• Update structure
• Add new sections
• Full SEO optimization
• Est. time: 4 hours

• Start from scratch
• Use /research for new brief
• Create new outline
• Treat as new content
• Est. time: 6+ hours

​

3. Preserve What Works

• Keep sections that rank well
• Maintain successful structure
• Preserve strong examples
• Keep effective formatting

• Statistics and dates
• Screenshots and images
• Examples and case studies
• Current year in title
• Links (internal and external)

​

4. Focus on Gaps

• Content gaps vs competitors
• Missing “People Also Ask” answers
• Outdated information
• Weak sections
• SEO issues

• New sections competitors have
• Updated data and research
• Better examples
• Visual content
• Improved formatting

​

5. Update Everything

• Current year in title and meta
• All statistics updated
• All examples refreshed
• All links checked (no 404s)
• All images updated
• Meta title/description optimized
• Internal links current
• Heading structure improved

​

Maximizing Content Quality

​

Study Examples

1. Read 2-3 articles from writing-examples.md
2. Note what makes them effective
3. Identify patterns in voice and structure
4. Emulate style (not content)

• Bookmark your best-performing articles
• Note what made them successful
• Use as templates for structure
• Reference for voice consistency

​

Use Data Heavily

• “Many people use social media”
• “Content marketing is effective”
• “SEO takes time”

• “4.9 billion people use social media globally (Datareportal, 2026)”
• “Content marketing generates 3x more leads than traditional marketing at 62% lower cost (Demand Metric, 2026)”
• “New content takes 3-6 months to reach peak rankings (Ahrefs Study, 2026)”

• Industry reports (HubSpot, Gartner, Forrester)
• Research studies
• Government data (.gov)
• Academic research (.edu)
• Your own analytics

​

Be Specific

• “Significant improvement”
• “Most experts agree”
• “Best practices suggest”

• “40% increase in organic traffic”
• “87% of marketers surveyed by Content Marketing Institute”
• “Google’s Search Quality Guidelines recommend”

​

Show, Don’t Tell

• Real name/company (or detailed scenario)
• Specific numbers
• Clear outcome
• Relatable context

​

Answer Questions

• Check research brief for PAA questions
• Create FAQ section
• Answer concisely (2-3 sentences each)
• Use FAQ schema markup

• “How long does this take?”
• “How much does it cost?”
• “What if I don’t have X?”
• “Can I do this without Y?”

​

SEO Optimization Tips

​

Keywords Early

• H1 title (required)
• First H2 heading
• Meta title and description

​

Natural Integration

• Do keywords sound natural?
• Would you speak this way?
• Any awkward repetition?

• Use synonyms
• Rephrase sentences
• Use pronouns (it, this, that)
• Focus on semantic variations

​

Vary Anchor Text

Learn more about [content marketing].
Read our [content marketing] guide.
Check out [content marketing] tips.

Learn more about [creating a content strategy].
Read our [complete guide to content marketing].
Check out these [proven content distribution tactics].

• Exact match: “content marketing guide”
• Partial match: “guide to content marketing”
• Branded: “HubSpot’s content marketing tool”
• Generic: “learn more about content strategy”
• Naked URL: https://yoursite.com/content-marketing

​

Link Strategically

1. Link to pillar content from cluster articles
2. Link between cluster articles when relevant
3. Link from high-authority pages to new content
4. Link early (first 300 words)
5. Link contextually (within content, not just end)

• Navigational: Related content, next steps
• Definitional: “Learn what content marketing is”
• Supporting: Data, research, case studies
• Conversion: Product pages, pricing, demos

​

Update Regularly

• Update statistics
• Refresh examples
• Check links
• Update year in title

• Comprehensive review
• Rewrite if needed
• Add new sections
• Full SEO audit

• Analyze what changed
• Update to match search intent
• Improve to beat competitors
• Add fresh content

• Rankings dropped >5 positions
• Traffic down >20%
• Statistics >1 year old
• Examples outdated
• Competitor content better

​

Avoiding Common Mistakes

​

Don’t Skip Research

• Wrong search intent
• Miss content gaps
• Incorrect word count
• Poor structure
• Low rankings

​

Don’t Ignore Brand Voice

• Doesn’t sound like your brand
• Lacks personality
• Low engagement
• Poor conversion

• Study brand-voice.md
• Read writing-examples.md
• Use /scrub to remove AI patterns
• Add human touches

​

Don’t Force Keywords

• Penalty from Google
• Unreadable content
• Low user engagement
• Poor rankings

• Target 1-2% density
• Read aloud to check naturalness
• Use synonyms and variations
• Focus on semantic relevance

​

Don’t Forget Internal Links

• Poor site architecture
• Missed SEO value
• Low page depth
• Poor user journey

• 3-5 internal links minimum
• Use internal-links-map.md
• Link early and contextually
• Descriptive anchor text

​

Don’t Copy Competitors

• Duplicate content issues
• No differentiation
• Low rankings
• No unique value

• Study competitors for gaps
• Provide unique insights
• Add original data/examples
• Better formatting/visuals
• Superior depth

​

Don’t Publish Without Optimization

• Missed SEO issues
• Preventable ranking problems
• Lower quality score
• More revisions later

• Always run /optimize
• Address CRITICAL/HIGH issues
• Verify score >80
• Complete pre-publishing checklist

​

Don’t Ignore Analytics

• Don’t know what works
• Can’t improve strategy
• Miss opportunities
• Waste effort on wrong content

• Run /performance-review monthly
• Track rankings in GSC
• Monitor traffic in GA4
• Use research scripts regularly

​

Advanced Techniques

​

Topic Cluster Strategy

1. Identify weak clusters: Run research_topic_clusters.py
2. Create pillar page: 3,000+ word comprehensive guide
3. Create cluster content: 8-12 supporting articles
4. Internal link strategy:
   • All cluster articles link to pillar
   • Pillar links to all cluster articles
   • Cluster articles link to each other
5. Monitor authority: Track average position for cluster

​

Content Refresh Strategy

1. Identify candidates: Run research_performance_matrix.py
2. Prioritize:
   • Stars declining: CRITICAL
   • Underperformers: HIGH
   • Declining content: MEDIUM
3. Batch updates:
   • Week 1: Underperformer titles/meta
   • Week 2-3: Declining content refresh
   • Week 4+: Star expansion
4. Track impact: Monitor ranking/traffic changes

​

Competitive Differentiation

1. Better data: Include proprietary research
2. Better examples: Real customer success stories
3. Better visuals: Custom graphics and diagrams
4. Better depth: More comprehensive coverage
5. Better tools: Include templates, calculators, checklists
6. Better writing: More engaging and readable

​

Conversion Optimization

1. Strong introduction: Hook → Problem → Promise (first 100 words)
2. Value demonstration: Prove expertise with examples
3. Strategic CTAs:
   • Soft CTA: Mid-article (subscribe, download)
   • Hard CTA: End (demo, trial, pricing)
4. Trust signals:
   • Customer logos
   • Statistics
   • Case studies
   • Testimonials
5. Clear next step: Don’t leave readers wondering

​

Maintenance & Iteration

​

Weekly

• Add new topic ideas to topics/
• Review drafts/ for stalled articles
• Run research_trending.py for hot topics
• Check GSC for ranking changes
• Update target-keywords.md with new opportunities

​

Monthly

• Run /performance-review or research_performance_matrix.py
• Update top 10 performing articles
• Check for broken links
• Add new published content to internal-links-map.md
• Review and update writing-examples.md if better examples emerge
• Track competitor activity

​

Quarterly

• Full audit of all context files
• Update SEO guidelines based on algorithm changes
• Comprehensive competitor analysis refresh
• Review and update topic clusters
• Strategic planning for next quarter
• Analyze what worked, what didn’t

​

Annually

• Complete content audit (all pages)
• Refresh brand voice if needed
• Update style guide
• Review and revise keyword strategy
• Comprehensive competitive analysis
• Set goals for next year

​

Success Metrics

​

Track These Metrics

• Average position for target keywords
• Keywords on page 1
• Keywords on page 2 (quick wins)
• Position changes month-over-month

• Organic sessions
• Pages per session
• Average time on page
• Bounce rate
• Conversion rate

• Comments
• Social shares
• Backlinks acquired
• Email signups
• Download/template requests

• Content scores (from analyzer)
• SEO scores
• Publishing frequency
• Time to publish

​

Set Goals

• Move 10 quick wins to page 1
• Increase organic traffic 25%
• Publish 12 optimized articles
• Build 1 topic cluster (10 articles)

• 40% of target keywords on page 1
• 50% increase in organic traffic
• Publish 24 articles
• Build 3 topic clusters
• Reduce bounce rate 15%

• 60% of target keywords on page 1
• Double organic traffic
• Publish 48 articles
• Build 6 topic clusters
• Achieve #1 ranking for 10 target keywords

​

Measure ROI

• Time spent writing
• Tool costs (APIs, software)
• Resources used

• Organic traffic value
• Leads generated
• Customers acquired
• Brand awareness lift

ROI = (Revenue from Organic Traffic - Content Investment) / Content Investment × 100%

​

Quick Reference

1. ✅ /research [topic]
2. ✅ Review context files
3. ✅ Check keyword strategy
4. ✅ Plan internal links

1. ✅ Follow research brief
2. ✅ Integrate keywords naturally
3. ✅ Add specific examples
4. ✅ Cite all sources
5. ✅ Provide unique value

1. ✅ Review agent reports
2. ✅ Address CRITICAL/HIGH issues
3. ✅ Run /optimize
4. ✅ Self-edit (read aloud)
5. ✅ Verify quality checklist

• ✅ Content score: 80+
• ✅ SEO score: 80+
• ✅ All CRITICAL issues: 0
• ✅ Checklist: 100% complete

1. ✅ Submit to GSC
2. ✅ Share on social
3. ✅ Track rankings weekly
4. ✅ Update quarterly
5. ✅ Measure ROI