claude-skills-reference/docs/agents/cs-demand-gen-specialist.md

title, description

title	description
Demand Generation Specialist Agent — AI Coding Agent & Codex Skill	Demand generation and customer acquisition specialist for lead generation, conversion optimization, and multi-channel acquisition campaigns. Agent-native orchestrator for Claude Code, Codex, Gemini CLI.

Demand Generation Specialist Agent

:material-robot: Agent :material-bullhorn-outline: Marketing :material-github: Source

Purpose

The cs-demand-gen-specialist agent is a specialized marketing agent focused on demand generation, lead acquisition, and conversion optimization. This agent orchestrates the marketing-demand-acquisition skill package to help teams build scalable customer acquisition systems, optimize conversion funnels, and maximize marketing ROI across channels.

This agent is designed for growth marketers, demand generation managers, and founders who need to generate qualified leads and convert them efficiently. By leveraging acquisition analytics, funnel optimization frameworks, and channel performance analysis, the agent enables data-driven decisions that improve customer acquisition cost (CAC) and lifetime value (LTV) ratios.

The cs-demand-gen-specialist agent bridges the gap between marketing strategy and measurable business outcomes, providing actionable insights on channel performance, conversion bottlenecks, and campaign effectiveness. It focuses on the entire demand generation funnel from awareness to qualified lead.

Skill Integration

Skill Location: marketing-skill/marketing-demand-acquisition

Python Tools

1. CAC Calculator
   • Purpose: Calculates Customer Acquisition Cost (CAC) across channels and campaigns
   • Path: scripts/calculate_cac.py
   • Usage: python ../../marketing-skill/marketing-demand-acquisition/scripts/calculate_cac.py campaign-spend.csv customer-data.csv
   • Features: CAC calculation by channel, LTV:CAC ratio, payback period analysis, ROI metrics
   • Use Cases: Budget allocation, channel performance evaluation, campaign ROI analysis

Note: Additional tools (demand_gen_analyzer.py, funnel_optimizer.py) planned for future releases per marketing roadmap.

Knowledge Bases

1. Attribution Guide

   • Location: references/attribution-guide.md
   • Content: Marketing attribution models, channel attribution, ROI measurement frameworks
   • Use Case: Campaign attribution, channel performance analysis, budget justification

2. Campaign Templates

   • Location: references/campaign-templates.md
   • Content: Reusable campaign structures, launch checklists, multi-channel campaign blueprints
   • Use Case: Campaign planning, rapid campaign setup, standardized launch processes

3. HubSpot Workflows

   • Location: references/hubspot-workflows.md
   • Content: HubSpot automation workflows, lead nurturing sequences, CRM integration patterns
   • Use Case: Marketing automation, lead scoring, nurture campaign setup

4. International Playbooks

   • Location: references/international-playbooks.md
   • Content: International market expansion strategies, localization best practices, regional channel optimization
   • Use Case: Global campaign planning, market entry strategy, cross-border demand generation

Templates

No asset templates currently available — use campaign-templates.md reference for campaign structure guidance.

Workflows

Workflow 1: Multi-Channel Acquisition Campaign Launch

Goal: Plan and launch demand generation campaign across multiple acquisition channels

Steps:

1. Define Campaign Goals - Set targets for leads, MQLs, SQLs, conversion rates
2. Reference Campaign Templates - Review proven campaign structures and launch checklists

   cat ../../marketing-skill/marketing-demand-acquisition/references/campaign-templates.md
   

3. Select Channels - Choose optimal mix based on target audience, budget, and attribution models

   cat ../../marketing-skill/marketing-demand-acquisition/references/attribution-guide.md
   

4. Set Up Automation - Configure HubSpot workflows for lead nurturing

   cat ../../marketing-skill/marketing-demand-acquisition/references/hubspot-workflows.md
   

5. Plan International Reach - Reference international playbooks if targeting multiple markets

   cat ../../marketing-skill/marketing-demand-acquisition/references/international-playbooks.md
   

6. Launch and Monitor - Deploy campaigns, track metrics, collect data

Expected Output: Structured campaign plan with channel strategy, budget allocation, success metrics

Time Estimate: 4-6 hours for campaign planning and setup

Workflow 2: Conversion Funnel Analysis & Optimization

Goal: Identify and fix conversion bottlenecks in acquisition funnel

Steps:

1. Export Campaign Data - Gather metrics from all acquisition channels (GA4, ad platforms, CRM)
2. Calculate Channel CAC - Run CAC calculator to analyze cost efficiency

   python ../../marketing-skill/marketing-demand-acquisition/scripts/calculate_cac.py campaign-spend.csv conversions.csv
   

3. Map Conversion Funnel - Visualize drop-off points using campaign templates as structure guide

   cat ../../marketing-skill/marketing-demand-acquisition/references/campaign-templates.md
   

4. Identify Bottlenecks - Analyze conversion rates at each funnel stage:
   • Awareness → Interest (CTR)
   • Interest → Consideration (landing page conversion)
   • Consideration → Intent (form completion)
   • Intent → Purchase/MQL (qualification rate)
5. Reference Attribution Guide - Review attribution models to identify problem areas

   cat ../../marketing-skill/marketing-demand-acquisition/references/attribution-guide.md
   

6. Implement A/B Tests - Test hypotheses for improvement
7. Re-calculate CAC Post-Optimization - Measure cost efficiency improvements

   python ../../marketing-skill/marketing-demand-acquisition/scripts/calculate_cac.py post-optimization-spend.csv post-optimization-conversions.csv
   

Expected Output: 15-30% reduction in CAC and improved LTV:CAC ratio

Time Estimate: 6-8 hours for analysis and optimization planning

Example:

# Complete CAC analysis workflow
python ../../marketing-skill/marketing-demand-acquisition/scripts/calculate_cac.py q3-spend.csv q3-conversions.csv > cac-report.txt
cat cac-report.txt
# Review metrics and optimize high-CAC channels

Workflow 3: Channel Performance Benchmarking

Goal: Evaluate and compare performance across acquisition channels to optimize budget allocation

Steps:

1. Collect Channel Data - Export metrics from each acquisition channel:
   • Google Ads (CPC, CTR, conversion rate, CPA)
   • LinkedIn Ads (impressions, clicks, leads, cost per lead)
   • Facebook Ads (reach, engagement, conversions, ROAS)
   • Content Marketing (organic traffic, leads, MQLs)
   • Email Campaigns (open rate, click rate, conversions)
2. Run CAC Comparison - Calculate and compare CAC across all channels

   python ../../marketing-skill/marketing-demand-acquisition/scripts/calculate_cac.py channel-spend.csv channel-conversions.csv
   

3. Reference Attribution Guide - Understand attribution models and benchmarks for each channel

   cat ../../marketing-skill/marketing-demand-acquisition/references/attribution-guide.md
   

4. Calculate Key Metrics:
   • CAC (Customer Acquisition Cost) by channel
   • LTV:CAC ratio
   • Conversion rate
   • Time to MQL/SQL
5. Optimize Budget Allocation - Shift budget to highest-performing channels
6. Document Learnings - Create playbook for future campaigns

Expected Output: Data-driven budget reallocation plan with projected ROI improvement

Time Estimate: 3-4 hours for comprehensive channel analysis

Workflow 4: Lead Magnet Campaign Development

Goal: Create and launch lead magnet campaign to capture high-quality leads

Steps:

1. Define Lead Magnet - Choose format: ebook, webinar, template, assessment, free trial
2. Reference Campaign Templates - Review lead capture and campaign structure best practices

   cat ../../marketing-skill/marketing-demand-acquisition/references/campaign-templates.md
   

3. Create Landing Page - Design high-converting landing page with:
   • Clear value proposition
   • Compelling CTA
   • Minimal form fields (name, email, company)
   • Social proof (testimonials, logos)
4. Set Up Campaign Tracking - Configure analytics and attribution
5. Launch Multi-Channel Promotion:
   • Paid social ads (LinkedIn, Facebook)
   • Email to existing list
   • Organic social posts
   • Blog post with CTA
6. Monitor and Optimize - Track CAC and conversion metrics

   # Weekly CAC analysis
   python ../../marketing-skill/marketing-demand-acquisition/scripts/calculate_cac.py lead-magnet-spend.csv lead-magnet-conversions.csv
   

Expected Output: Lead magnet campaign generating 100-500 leads with 25-40% conversion rate

Time Estimate: 8-12 hours for development and launch

Integration Examples

Example 1: Automated Campaign Performance Dashboard

#!/bin/bash
# campaign-dashboard.sh - Daily campaign performance summary

DATE=$(date +%Y-%m-%d)

echo "📊 Demand Gen Dashboard - $DATE"
echo "========================================"

# Calculate yesterday's CAC by channel
python ../../marketing-skill/marketing-demand-acquisition/scripts/calculate_cac.py \
  daily-spend.csv daily-conversions.csv

echo ""
echo "💰 Budget Status:"
cat budget-tracking.txt

echo ""
echo "🎯 Today's Priorities:"
cat optimization-priorities.txt

Example 2: Weekly Channel Performance Report

# Generate weekly CAC report for stakeholders
python ../../marketing-skill/marketing-demand-acquisition/scripts/calculate_cac.py \
  weekly-spend.csv weekly-conversions.csv > weekly-cac-report.txt

# Email to stakeholders
echo "Weekly CAC analysis report attached." | \
  mail -s "Weekly CAC Report" -a weekly-cac-report.txt stakeholders@company.com

Example 3: Real-Time Funnel Monitoring

# Monitor CAC in real-time (run daily via cron)
CAC_RESULT=$(python ../../marketing-skill/marketing-demand-acquisition/scripts/calculate_cac.py \
  daily-spend.csv daily-conversions.csv | grep "Average CAC" | awk '{print $3}')

CAC_THRESHOLD=50

# Alert if CAC exceeds threshold
if (( $(echo "$CAC_RESULT > $CAC_THRESHOLD" | bc -l) )); then
  echo "🚨 Alert: CAC ($CAC_RESULT) exceeds threshold ($CAC_THRESHOLD)!" | \
    mail -s "CAC Alert" demand-gen-team@company.com
fi

Success Metrics

Acquisition Metrics:

• Lead Volume: 20-30% month-over-month growth
• MQL Conversion Rate: 15-25% of total leads qualify as MQLs
• CAC (Customer Acquisition Cost): Decrease by 15-20% with optimization
• LTV:CAC Ratio: Maintain 3:1 or higher ratio

Channel Performance:

• Paid Search: CTR 3-5%, conversion rate 5-10%
• Paid Social: CTR 1-2%, CPL (cost per lead) benchmarked by industry
• Content Marketing: 30-40% of organic traffic converts to leads
• Email Campaigns: Open rate 20-30%, click rate 3-5%, conversion rate 2-5%

Funnel Optimization:

• Landing Page Conversion: 25-40% conversion rate on optimized pages
• Form Completion: 60-80% of visitors who start form complete it
• Lead Quality: 40-50% of MQLs convert to SQLs

Business Impact:

• Pipeline Contribution: Demand gen accounts for 50-70% of sales pipeline
• Revenue Attribution: Track $X in closed-won revenue to demand gen campaigns
• Payback Period: CAC recovered within 6-12 months

Related Agents

• cs-content-creator - Content creation for demand gen campaigns
• cs-product-marketing - Product positioning and messaging (planned)
• cs-growth-marketer - Growth hacking and viral acquisition (planned)

References

• Skill Documentation: ../../marketing-skill/marketing-demand-acquisition/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