Expert Content Marketer

An autonomous agent that develops content marketing strategies — creating editorial calendars, writing SEO-optimized content, designing distribution plans, and measuring content performance with conversion attribution.

When to Use This Agent

Choose Expert Content Marketer when:

• You need a content strategy aligned with business goals and SEO targets
• You want to create blog posts, case studies, or whitepapers with SEO optimization
• You need an editorial calendar with consistent publishing cadence
• You want to measure content ROI and optimize distribution channels

Consider alternatives when:

• You need social media post creation (use a social media agent)
• You need email marketing campaigns (use an email marketing agent)
• You need brand identity or visual design (use a brand designer)

Quick Start

Copy
# .claude/agents/content-marketer.yml
name: expert-content-marketer
description: Develop content marketing strategy and SEO content
agent_prompt: |
  You are a Content Marketing Expert. When creating content strategy:

  1. Define content pillars aligned with business goals
  2. Research keywords with search volume and intent
  3. Create editorial calendar with topic clusters
  4. Write SEO-optimized content with proper structure
  5. Plan distribution across channels
  6. Set up measurement and attribution

  Content principles:
  - Write for humans first, search engines second
  - Every piece needs a clear CTA and conversion path
  - Pillar + cluster model for topical authority
  - Repurpose: 1 long-form → blog + social + email + video

Example invocation:

Copy
claude "Create a 3-month content strategy for our developer tools SaaS targeting mid-market engineering teams"

Sample strategy output:

Content Strategy — Q2 2025
━━━━━━━━━━━━━━━━━━━━━━━━━━

Content Pillars:
  1. Developer Productivity (40% of content)
  2. Engineering Best Practices (30%)
  3. Tool Comparisons & Guides (20%)
  4. Customer Success Stories (10%)

Month 1 Editorial Calendar:
  Week 1: "10 Git Workflows That Speed Up Code Review" [SEO: 2.4K vol]
  Week 2: "CI/CD Pipeline Optimization Guide" [SEO: 1.8K vol]
  Week 3: Case Study: How Acme Reduced Deploy Time by 60%
  Week 4: "VS Code vs JetBrains for Enterprise Teams" [SEO: 3.1K vol]

Distribution Plan:
  Blog → Dev.to syndication → Twitter thread → LinkedIn carousel
  Newsletter: Weekly digest of new content
  Community: Share in relevant Discord/Slack communities

KPIs:
  - Organic traffic: +25% MoM
  - Email signups from content: 200/month
  - Content-attributed demos: 15/month

Core Concepts

Content Strategy Framework

Element	Description	Deliverable
Pillars	Core topic areas (3-5)	Content pillar document
Clusters	Subtopics within each pillar	Topic cluster maps
Calendar	Publishing schedule	Editorial calendar
Briefs	Individual content specifications	Content briefs
Distribution	Channel-specific promotion	Distribution playbook
Measurement	KPIs and attribution	Analytics dashboard

Topic Cluster Model

Pillar: Developer Productivity
├── Cluster: Code Review
│   ├── "How to Speed Up Code Review" (blog)
│   ├── "Code Review Checklist Template" (lead magnet)
│   ├── "Best Code Review Tools Compared" (comparison)
│   └── "Code Review Anti-Patterns" (blog)
├── Cluster: CI/CD
│   ├── "CI/CD Pipeline Best Practices" (pillar page)
│   ├── "GitHub Actions vs CircleCI" (comparison)
│   ├── "Reducing Build Times" (tutorial)
│   └── Case Study: FastDeploy (customer story)
└── Cluster: Developer Experience
    ├── "What is Developer Experience?" (pillar page)
    ├── "Measuring Developer Productivity" (blog)
    └── "Developer Onboarding Guide" (guide)

SEO Content Brief Template

Copy
## Content Brief: [Title]

**Target Keyword:** [primary keyword] (volume: X, difficulty: Y)
**Secondary Keywords:** [list]
**Search Intent:** Informational / Commercial / Transactional
**Target Word Count:** 1,500-2,000
**Target Audience:** [specific persona]

**Outline:**
  H1: [Title with primary keyword]
  H2: [Section 1 — address primary intent]
  H2: [Section 2 — supporting topic]
  H2: [Section 3 — practical examples]
  H2: [Section 4 — comparison/alternatives]
  H2: FAQ (target featured snippets)

**CTA:** [Specific conversion action]
**Internal Links:** [3-5 related pages to link to]
**Competitor Content:** [Top 3 ranking URLs to analyze]

Configuration

Option	Type	Default	Description
targetAudience	string	""	Primary audience persona
publishingCadence	string	"weekly"	Frequency: daily, weekly, biweekly
contentTypes	string[]	["blog", "guide", "case-study"]	Content formats
seoFocus	boolean	true	Optimize for search engines
distributionChannels	string[]	["blog", "social", "email"]	Distribution channels
measurementGoals	string[]	["traffic", "signups", "demos"]	KPIs to track

Best Practices

1. Build topical authority with clusters, not random posts — Search engines rank sites higher when they demonstrate comprehensive expertise on a topic. Instead of writing isolated posts, build topic clusters: one pillar page covering the broad topic comprehensively, and 5-10 cluster posts covering subtopics that link back to the pillar page.

2. Match content format to search intent — If the top results for a keyword are comparison tables, write a comparison. If they are tutorials, write a tutorial. If they are videos, create a video. Google ranks content that matches the format users expect, regardless of quality.

3. Create one piece of content, distribute in five formats — A 2,000-word blog post becomes: a Twitter thread (key takeaways), a LinkedIn carousel (visual summary), an email newsletter section, a YouTube video script, and a podcast discussion point. This multiplies reach without multiplying effort.

4. Gate high-value content, not basic information — Blog posts and tutorials should be freely accessible (they drive traffic and trust). Gate templates, calculators, benchmarks, and original research behind an email signup. This builds your email list with qualified leads who demonstrated interest.

5. Measure content by pipeline contribution, not just traffic — A post with 10K views and 0 conversions is less valuable than a post with 500 views and 20 demo requests. Set up content attribution that tracks which pieces drive email signups, demo requests, and eventually revenue. Optimize for bottom-of-funnel metrics, not vanity metrics.

Common Issues

Content ranks on page 2-3 but never reaches page 1 — The content is good enough to be indexed but lacks the authority signals to rank higher. Add internal links from high-authority pages on your site, earn backlinks through outreach and original data, and update the content with fresh statistics and examples every 6 months.

Blog traffic grows but conversions stay flat — High-traffic informational content ("what is CI/CD?") attracts readers who are not ready to buy. Balance informational content with commercial content ("best CI/CD tools for mid-size teams") that targets users with buying intent. Add clear CTAs to informational posts that guide readers to commercial content.

Editorial calendar is consistently behind schedule — Content production takes longer than planned because briefs are vague, reviews take multiple rounds, and resources are shared with other priorities. Build a 2-week buffer into the calendar, batch content creation (write 4 posts in one day), and create detailed briefs that reduce revision cycles.