Running Marketing Campaigns - Claude Agent Skill

A comprehensive Claude Code skill for planning, executing, and measuring digital marketing campaigns across content, social media, email, SEO, GEO, and analytics channels. Supports 14+ AI coding agents through the Agent Skill Standard.

Quick Start

# Install with skilz (recommended)
pip install skilz
skilz install -g https://github.com/SpillwaveSolutions/running-marketing-campaigns-agent-skill

# Or install from marketplace
skilz install SpillwaveSolutions_running-marketing-campaigns-agent-skill/running-marketing-campaigns

Then ask Claude:

• "Help me plan a product launch campaign"
• "Generate UTM parameters for my email newsletter"
• "Create a content calendar for Q1"
• "Define our brand voice guidelines"
• "Optimize my content for AI visibility (GEO)"

Features

• UTM Campaign Tracking - Generate, validate, and batch-process UTM parameters with GA4 channel alignment
• Content Strategy - Topic clusters, content calendars, funnel mapping, and repurposing workflows
• Email Marketing - Sequence templates, subject line optimization, segmentation strategies
• Social Media - Platform-specific tactics, posting schedules, engagement benchmarks
• Analytics & Measurement - KPI frameworks, attribution models, ROI calculations
• Go-to-Market - Launch frameworks (SOSTAC, RACE, AARRR), positioning methodology
• Brand Voice - Voice dimension matrix, tone guidelines, messaging frameworks, terminology standards
• SEO Optimization - Technical SEO, on-page optimization, content SEO, link building, E-E-A-T guidelines
• GEO (Generative Engine Optimization) - AI SEO, LLMO, AEO for ChatGPT, Perplexity, Google AI Overviews visibility

Installing with Skilz (Universal Installer)

The recommended way to install this skill across different AI coding agents is using the skilz universal installer. This skill supports the Agent Skill Standard, which means it works with 14+ coding agents including Claude Code, OpenAI Codex, Cursor, and Gemini CLI.

Install Skilz

pip install skilz

Git URL Options

You can use either -g or --git with HTTPS or SSH URLs:

# HTTPS URL
skilz install -g https://github.com/SpillwaveSolutions/running-marketing-campaigns-agent-skill

# SSH URL
skilz install --git [email protected]:SpillwaveSolutions/running-marketing-campaigns-agent-skill.git

Claude Code

Install to user home (available in all projects):

skilz install -g https://github.com/SpillwaveSolutions/running-marketing-campaigns-agent-skill

Install to current project only:

skilz install -g https://github.com/SpillwaveSolutions/running-marketing-campaigns-agent-skill --project

OpenCode

Install for OpenCode:

skilz install -g https://github.com/SpillwaveSolutions/running-marketing-campaigns-agent-skill --agent opencode

Project-level install:

skilz install -g https://github.com/SpillwaveSolutions/running-marketing-campaigns-agent-skill --project --agent opencode

Gemini

Project-level install for Gemini:

skilz install -g https://github.com/SpillwaveSolutions/running-marketing-campaigns-agent-skill --agent gemini

OpenAI Codex

Install for OpenAI Codex:

skilz install -g https://github.com/SpillwaveSolutions/running-marketing-campaigns-agent-skill --agent codex

Project-level install:

skilz install -g https://github.com/SpillwaveSolutions/running-marketing-campaigns-agent-skill --project --agent codex

Install from Skillzwave Marketplace

# Claude to user home dir ~/.claude/skills
skilz install SpillwaveSolutions_running-marketing-campaigns-agent-skill/running-marketing-campaigns

# Claude skill in project folder ./claude/skills
skilz install SpillwaveSolutions_running-marketing-campaigns-agent-skill/running-marketing-campaigns --project

# OpenCode install to user home dir ~/.config/opencode/skills
skilz install SpillwaveSolutions_running-marketing-campaigns-agent-skill/running-marketing-campaigns --agent opencode

# OpenCode project level
skilz install SpillwaveSolutions_running-marketing-campaigns-agent-skill/running-marketing-campaigns --agent opencode --project

# OpenAI Codex install to user home dir ~/.codex/skills
skilz install SpillwaveSolutions_running-marketing-campaigns-agent-skill/running-marketing-campaigns --agent codex

# OpenAI Codex project level ./.codex/skills
skilz install SpillwaveSolutions_running-marketing-campaigns-agent-skill/running-marketing-campaigns --agent codex --project

# Gemini CLI (project level) -- only works with project level
skilz install SpillwaveSolutions_running-marketing-campaigns-agent-skill/running-marketing-campaigns --agent gemini

See Skill Listing to see how to install this exact skill to 14+ different coding agents.

Other Supported Agents

Skilz supports 14+ coding agents including Windsurf, Qwen Code, Aidr, and more.

For the full list of supported platforms, visit SkillzWave.ai/platforms or see the skilz-cli GitHub repository.

---

Manual Installation

Claude Code

# Clone to your Claude skills directory
git clone https://github.com/SpillwaveSolutions/running-marketing-campaigns-agent-skill.git \
  ~/.claude/skills/running-marketing-campaigns

Other Methods

1. Download or clone this repository
2. Copy the contents to ~/.claude/skills/running-marketing-campaigns/
3. Restart Claude Code to load the skill

Usage

The skill activates automatically when you ask Claude about:

• Creating marketing campaigns and go-to-market strategies
• Planning content strategy and topic clusters
• Building email sequences and drip campaigns
• Setting up UTM campaign tracking
• Analyzing marketing metrics and KPIs
• Launching products with SOSTAC/RACE/AARRR frameworks
• Defining brand voice and messaging guidelines
• Optimizing for SEO (technical, on-page, content)
• Optimizing for AI visibility (GEO, LLMO, AEO)

Example Prompts

"Help me plan a product launch campaign"
"Generate UTM parameters for my email newsletter"
"Create a content calendar for Q1"
"What KPIs should I track for social media?"
"Define our brand voice guidelines"
"Check if my marketing copy follows brand guidelines"
"Optimize my content for ChatGPT and Perplexity visibility"
"Create an SEO strategy for my SaaS product"

Scripts

Two Python utilities are included for automation:

utm_tools.py

Generate, validate, and audit UTM tracking URLs.

# Generate UTM parameters
python scripts/utm_tools.py generate -s facebook -m paid-social -c spring-2025

# Build complete tracking URL
python scripts/utm_tools.py build -u https://example.com -s email -m newsletter -c q1-launch

# Validate existing URL
python scripts/utm_tools.py validate -u "https://example.com?utm_source=email&utm_medium=cpc"

# Batch process from CSV
python scripts/utm_tools.py batch -f campaigns.csv -u https://example.com -o tracking.csv

# Check GA4 channel mapping
python scripts/utm_tools.py ga4-check -s facebook -m paid-social

# Audit URLs for case inconsistencies
python scripts/utm_tools.py audit -f urls.txt

# Generate QR code (requires: pip install qrcode pillow)
python scripts/utm_tools.py qr -u "https://example.com?utm_source=qr" -o code.png

brand_checker.py

Validate marketing copy against brand guidelines.

# Full compliance check
python scripts/brand_checker.py check --file marketing_copy.txt

# Check readability score
python scripts/brand_checker.py readability --text "Your marketing copy here"

# Find banned words and phrases
python scripts/brand_checker.py banned --file email_draft.txt

# Check terminology consistency
python scripts/brand_checker.py terminology --file copy.txt

# Full audit with JSON output
python scripts/brand_checker.py full-audit --file campaign.txt --output report.json

# List all banned words
python scripts/brand_checker.py list-banned

Structure

running-marketing-campaigns/
├── SKILL.md                          # Main skill definition
├── README.md                         # This file
├── LICENSE                           # MIT License
├── references/
│   ├── analytics-measurement.md      # KPIs, GA4, attribution, ROI
│   ├── brand-guidelines.md           # Voice, tone, messaging, terminology
│   ├── content-strategy.md           # Topic clusters, calendars, funnel mapping
│   ├── email-marketing.md            # Sequences, subject lines, deliverability
│   ├── geo-optimization.md           # GEO, LLMO, AEO, AI visibility
│   ├── gtm-tools.md                  # Launch frameworks, positioning
│   ├── seo-optimization.md           # Technical, on-page, content SEO
│   ├── social-media.md               # Platform tactics, benchmarks
│   └── utm-tracking.md               # UTM formatting, GA4 alignment
└── scripts/
    ├── brand_checker.py              # Brand voice compliance checker
    └── utm_tools.py                  # UTM generation and validation

Reference Guides

| Reference | Purpose | |-----------|---------| | content-strategy.md | Topic clusters, Hero-Hub-Hygiene, funnel mapping, atomization | | social-media.md | Platform-specific tactics, posting times, algorithm priorities | | email-marketing.md | Sequences, subject lines, segmentation, deliverability | | utm-tracking.md | UTM parameters, naming conventions, GA4 channel alignment | | analytics-measurement.md | Marketing funnel KPIs, attribution models, reporting templates | | gtm-tools.md | SOSTAC, RACE, AARRR frameworks, launch planning | | brand-guidelines.md | Voice dimensions, tone adaptation, messaging framework | | seo-optimization.md | Technical SEO, on-page, content SEO, link building, E-E-A-T | | geo-optimization.md | Generative Engine Optimization, LLMO, AEO, AI visibility |

Brand Voice Features

The skill includes comprehensive brand voice tooling:

Voice Dimensions Matrix

Define brand voice across 4 spectrums:

• Formality: Formal ↔ Casual
• Energy: Reserved ↔ Enthusiastic
• Humor: Serious ↔ Playful
• Authority: Peer ↔ Expert

This-But-Not-That Chart

Clarify voice traits with boundaries:

| Trait | This Means... | But NOT... | |-------|---------------|------------| | Helpful | Guiding with expertise | Patronizing | | Confident | Speaking with authority | Arrogant | | Clear | Simple explanations | Dumbed down |

Banned Words Detection

Automatically flag:

• Unsubstantiated superlatives ("best-in-class", "revolutionary")
• Corporate jargon ("synergy", "leverage", "circle back")
• Vague promises ("seamless", "frictionless", "robust")

Requirements

• Any supported AI coding agent (Claude Code, OpenAI Codex, Gemini CLI, etc.)
• skilz for universal installation (recommended)
• Python 3.8+ (for scripts)
• Optional: qrcode, pillow (for QR code generation)
• Optional: requests (for URL shortening via bit.ly)

License

MIT License - See LICENSE for details.

Contributing

Contributions welcome! Please:

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Submit a pull request

Related Resources

• Agent Skill Standard - Universal skill specification for AI coding agents
• skilz CLI - Universal installer for agent skills
• SkillzWave Marketplace - Browse and discover AI agent skills
• Claude Code Documentation
• GA4 Default Channel Groupings

---