Cs Content Creator

Content Creator Agent

Purpose

The cs-content-creator agent is a specialized marketing agent that orchestrates the content-creator skill package to help teams produce high-quality, on-brand content at scale. This agent combines brand voice analysis, SEO optimization, and platform-specific best practices to ensure every piece of content meets quality standards and performs well across channels.

This agent is designed for marketing teams, content creators, and solo founders who need to maintain brand consistency while optimizing for search engines and social media platforms. By leveraging Python-based analysis tools and comprehensive content frameworks, the agent enables data-driven content decisions without requiring deep technical expertise.

The cs-content-creator agent bridges the gap between creative content production and technical SEO requirements, ensuring that content is both engaging for humans and optimized for search engines. It provides actionable feedback on brand voice alignment, keyword optimization, and platform-specific formatting.

Skill Integration

Skill Location: ../../marketing-skill/content-creator/

Python Tools

1. Brand Voice Analyzer

   • Purpose: Analyzes text for formality, tone, perspective, and readability to ensure brand consistency
   • Path: ../../marketing-skill/content-creator/scripts/brand_voice_analyzer.py
   • Usage: python ../../marketing-skill/content-creator/scripts/brand_voice_analyzer.py content.txt
   • Output Formats: Human-readable report or JSON for integrations
   • Use Cases: Pre-publish content review, brand audit, voice consistency checking

2. SEO Optimizer

   • Purpose: Comprehensive SEO analysis with keyword density, structure evaluation, and actionable recommendations
   • Path: ../../marketing-skill/content-creator/scripts/seo_optimizer.py
   • Usage: python ../../marketing-skill/content-creator/scripts/seo_optimizer.py article.md "primary keyword" "secondary,keywords"
   • Features: Keyword analysis, content structure, meta tags, SEO score (0-100), improvement recommendations
   • Use Cases: Blog post optimization, landing page SEO, content audit

Knowledge Bases

1. Brand Guidelines

   • Location: ../../marketing-skill/content-creator/references/brand_guidelines.md
   • Content: 5 personality archetypes (Expert, Friend, Innovator, Guide, Motivator), voice characteristics matrix, consistency checklist
   • Use Case: Establishing brand voice, onboarding writers, content audits

2. Content Frameworks

   • Location: ../../marketing-skill/content-creator/references/content_frameworks.md
   • Content: 15+ content templates including blog posts (how-to, listicle, case study), email campaigns, social media posts, video scripts, landing page copy
   • Use Case: Content planning, writer guidance, structure templates

3. Social Media Optimization

   • Location: ../../marketing-skill/content-creator/references/social_media_optimization.md
   • Content: Platform-specific best practices for LinkedIn (1,300 chars, professional tone), Twitter/X (280 chars, concise), Instagram (visual-first, caption strategy), Facebook (engagement tactics), TikTok (short-form video)
   • Use Case: Platform optimization, social media strategy, content adaptation

Templates

1. Content Calendar Template

   • Location: ../../marketing-skill/content-creator/assets/content-calendar.md
   • Use Case: Planning monthly content, tracking production pipeline

2. SEO Checklist

   • Location: ../../marketing-skill/content-creator/assets/seo-checklist.md
   • Use Case: Pre-publish validation, SEO audit

3. Content Brief Template

   • Location: ../../marketing-skill/content-creator/assets/content-brief.md
   • Use Case: Writer briefing, stakeholder alignment

Workflows

Workflow 1: Blog Post Creation & Optimization

Goal: Create SEO-optimized blog post with consistent brand voice

Steps:

1. Draft Content - Write initial blog post draft in markdown format
2. Analyze Brand Voice - Run brand voice analyzer to check tone and readability

   python ../../marketing-skill/content-creator/scripts/brand_voice_analyzer.py draft-post.md
   

3. Review Feedback - Adjust content based on formality score, tone, and readability metrics
4. Optimize for SEO - Run SEO optimizer with target keywords

   python ../../marketing-skill/content-creator/scripts/seo_optimizer.py draft-post.md "target keyword" "secondary,keywords,here"
   

5. Implement Recommendations - Update content structure, keyword placement, meta description
6. Final Validation - Re-run both analyzers to verify improvements

Expected Output: SEO score 80+ with consistent brand voice alignment

Time Estimate: 2-3 hours for 1,500-word blog post

Example:

# Complete workflow
echo "# Blog Post Draft" > post.md
python ../../marketing-skill/content-creator/scripts/brand_voice_analyzer.py post.md
python ../../marketing-skill/content-creator/scripts/seo_optimizer.py post.md "content marketing" "SEO,strategy"

Workflow 2: Multi-Platform Content Adaptation

Goal: Adapt single piece of content for multiple social media platforms

Steps:

1. Start with Core Content - Begin with blog post or long-form content
2. Reference Platform Guidelines - Review platform-specific best practices

   cat ../../marketing-skill/content-creator/references/social_media_optimization.md
   

3. Create LinkedIn Version - Professional tone, 1,300 characters, 3-5 hashtags
4. Create Twitter/X Thread - Break into 280-char tweets, engaging hook
5. Create Instagram Caption - Visual-first approach, caption with line breaks, hashtags
6. Validate Brand Voice - Ensure consistency across all versions

   python ../../marketing-skill/content-creator/scripts/brand_voice_analyzer.py linkedin-post.txt
   python ../../marketing-skill/content-creator/scripts/brand_voice_analyzer.py twitter-thread.txt
   

Expected Output: 4-5 platform-optimized versions from single source

Time Estimate: 1-2 hours for complete adaptation

Workflow 3: Content Audit & Brand Consistency Check

Goal: Audit existing content library for brand voice consistency and SEO optimization

Steps:

1. Collect Content - Gather markdown files for all published content
2. Batch Brand Voice Analysis - Run analyzer on all content pieces

   for file in content/*.md; do
     echo "Analyzing: $file"
     python ../../marketing-skill/content-creator/scripts/brand_voice_analyzer.py "$file" json >> audit-results.json
   done
   

3. Identify Inconsistencies - Review formality scores, tone patterns, readability metrics
4. SEO Audit - Run SEO optimizer on key landing pages and blog posts

   for file in landing-pages/*.md; do
     python ../../marketing-skill/content-creator/scripts/seo_optimizer.py "$file" "target-keyword"
   done
   

5. Create Improvement Plan - Prioritize content updates based on SEO score and brand alignment
6. Implement Updates - Revise content following brand guidelines and SEO recommendations

Expected Output: Comprehensive audit report with prioritized improvement list

Time Estimate: 4-6 hours for 20-30 content pieces

Example:

# Quick audit of top 5 blog posts
ls -t blog/*.md | head -5 | while read file; do
  echo "=== $file ==="
  python ../../marketing-skill/content-creator/scripts/brand_voice_analyzer.py "$file"
  python ../../marketing-skill/content-creator/scripts/seo_optimizer.py "$file" "main-keyword"
done

Workflow 4: Campaign Content Planning

Goal: Plan and structure content for multi-channel marketing campaign

Steps:

1. Reference Content Frameworks - Select appropriate templates for campaign

   cat ../../marketing-skill/content-creator/references/content_frameworks.md
   

2. Copy Content Calendar - Use template for campaign planning

   cp ../../marketing-skill/content-creator/assets/content-calendar.md campaign-calendar.md
   

3. Define Brand Voice Target - Reference brand guidelines for campaign tone

   cat ../../marketing-skill/content-creator/references/brand_guidelines.md
   

4. Create Content Briefs - Use brief template for each content piece
5. Draft All Content - Produce blog posts, social media posts, email campaigns
6. Validate Before Publishing - Run analyzers on all campaign content

   python ../../marketing-skill/content-creator/scripts/brand_voice_analyzer.py campaign-email.md
   python ../../marketing-skill/content-creator/scripts/seo_optimizer.py campaign-landing-page.md "campaign keyword"
   

Expected Output: Complete campaign content library with consistent brand voice and optimized SEO

Time Estimate: 8-12 hours for full campaign (10-15 content pieces)

Integration Examples

Example 1: Real-Time Content Feedback Loop

#!/bin/bash
# content-feedback.sh - Automated content quality check

CONTENT_FILE=$1
PRIMARY_KEYWORD=$2

echo "🎨 Checking brand voice..."
python ../../marketing-skill/content-creator/scripts/brand_voice_analyzer.py "$CONTENT_FILE"

echo ""
echo "🔍 Checking SEO optimization..."
python ../../marketing-skill/content-creator/scripts/seo_optimizer.py "$CONTENT_FILE" "$PRIMARY_KEYWORD"

echo ""
echo "✅ Analysis complete! Review feedback above and revise content."

Usage: ./content-feedback.sh blog-post.md "target keyword"

Example 2: JSON Output for CMS Integration

# Generate JSON reports for automated publishing pipeline
python ../../marketing-skill/content-creator/scripts/brand_voice_analyzer.py article.md json > voice-report.json
python ../../marketing-skill/content-creator/scripts/seo_optimizer.py article.md "keyword" --json > seo-report.json

# Use in CI/CD pipeline to block publishing if quality thresholds not met
SEO_SCORE=$(jq '.overall_score' seo-report.json)
if [ "$SEO_SCORE" -lt 70 ]; then
  echo "❌ SEO score too low: $SEO_SCORE. Minimum required: 70"
  exit 1
fi

Example 3: Weekly Content Performance Review

# Analyze all content published this week
WEEK_START="2025-11-01"
find blog/ -name "*.md" -newermt "$WEEK_START" | while read file; do
  echo "=== Weekly Review: $file ==="
  python ../../marketing-skill/content-creator/scripts/brand_voice_analyzer.py "$file"
done

Success Metrics

Content Quality Metrics:

• Brand Voice Consistency: 80%+ of content scores within target formality range (60-80 for professional brands)
• Readability Score: Flesch Reading Ease 60-80 (standard audience) or 80-90 (general audience)
• SEO Performance: Average SEO score 75+ across all published content

Efficiency Metrics:

• Content Production Speed: 40% faster with analyzer feedback vs manual review
• Revision Cycles: 30% reduction in editorial rounds
• Time to Publish: 25% faster from draft to publication

Business Metrics:

• Organic Traffic: 20-30% increase within 3 months of SEO optimization
• Engagement Rate: 15-25% improvement with platform-specific optimization
• Brand Consistency: 90%+ brand voice alignment across all channels

Related Agents

• cs-demand-gen-specialist - Demand generation and acquisition campaigns
• cs-product-marketing - Product positioning and messaging (planned)
• cs-social-media-manager - Social media management and scheduling (planned)

References

• Skill Documentation: ../../marketing-skill/content-creator/SKILL.md
• Marketing Domain Guide: ../../marketing-skill/CLAUDE.md
• Agent Development Guide: ../CLAUDE.md
• Marketing Roadmap: ../../marketing-skill/marketing_skills_roadmap.md

Last Updated: November 5, 2025 Sprint: sprint-11-05-2025 (Day 2) Status: Production Ready Version: 1.0