running-marketing-campaigns

SpillwaveSolutions/running-marketing-campaigns-agent-skill

Plans, creates, and optimizes digital marketing campaigns including content strategy, social media, email marketing, SEO, and AI visibility (GEO). Generates UTM parameters and tracking URLs. Helps develop go-to-market strategies, campaign messaging, content calendars, and performance measurement frameworks. Use when asked to "create a marketing campaign", "plan content strategy", "build email sequences", "set up UTM tracking", "analyze marketing metrics", "launch a product", "optimize for SEO", "improve AI visibility", "optimize for voice search", "set up IndexNow", "check accessibility for SEO", or "create social media previews". Supports both marketing beginners and experienced marketers needing templates.

1 stars

0 forks

Python

34 views

View on GitHub Add to Favorites

SKILL.md

name: running-marketing-campaigns description: > Plans, creates, and optimizes digital marketing campaigns including content strategy, social media, email marketing, SEO, and AI visibility (GEO). Generates UTM parameters and tracking URLs. Helps develop go-to-market strategies, campaign messaging, content calendars, and performance measurement frameworks. Use when asked to "create a marketing campaign", "plan content strategy", "build email sequences", "set up UTM tracking", "analyze marketing metrics", "launch a product", "optimize for SEO", "improve AI visibility", "optimize for voice search", "set up IndexNow", "check accessibility for SEO", or "create social media previews". Supports both marketing beginners and experienced marketers needing templates. license: MIT metadata: version: 1.3.0 domains: [content, social, email, analytics, gtm, brand, seo, geo, voice-search, accessibility] author: Claude Skills

Marketing Campaign Execution

Plan, execute, and measure digital marketing campaigns across content, social, email, and analytics.

Quick Start

Generate UTM Parameters

Source: where traffic originates (google, facebook, newsletter)
Medium: how it arrives (cpc, email, social, organic)
Campaign: initiative name (spring-sale-2025, product-launch)

Format: lowercase, hyphens, no spaces
Input: "Spring Sale 2025" → Output: "spring-sale-2025"
Input: "Q1 Launch Campaign" → Output: "q1-launch-campaign"

Example: ?utm_source=linkedin&utm_medium=social&utm_campaign=q1-launch

Create Email Sequence

Welcome (immediate): Set expectations, deliver promised value
Value (day 2-3): Best content or quick win
Engagement (day 5-7): Encourage reply or action
Offer (day 10): Clear CTA with incentive

Plan Content Calendar

Essential fields: Title, Target keyword, Funnel stage (TOFU/MOFU/BOFU), Format, Owner, Publish date, Distribution channels.

Check Campaign Performance

Primary metrics by channel:

Email: Open rate (43% avg), CTR (2% avg), Conversion rate
Social: Engagement rate, Reach, Click-through
Paid: ROAS, CPA, CTR
Content: Traffic, Time on page, Conversions

Domain Reference Guide

Need	Reference	When to Load
Plan content strategy	content-strategy.md	Topic clusters, calendars, funnel mapping, repurposing
Execute social media	social-media.md	Platform tactics, posting times, engagement benchmarks
Build email campaigns	email-marketing.md	Sequences, subject lines, segmentation, deliverability
Track campaigns	utm-tracking.md	UTM formatting, naming conventions, GA4 alignment
Measure performance	analytics-measurement.md	KPIs, GA4 setup, attribution, ROI calculations
Launch products	gtm-tools.md	GTM frameworks, positioning, tool selection
Define brand voice	brand-guidelines.md	Voice dimensions, tone, messaging framework, terminology
Optimize for search	seo-optimization.md	Technical SEO, on-page, content SEO, link building, E-E-A-T
Optimize for AI	geo-optimization.md	GEO, LLMO, AEO, AI Overviews, chatbot visibility

Scripts

Python utilities for campaign automation:

Script	Purpose	Usage
utm_tools.py	UTM generation, validation, batch processing, QR codes	`python utm_tools.py generate --source facebook --medium paid-social --campaign q1-launch`
brand_checker.py	Brand voice compliance, readability scoring, banned words	`python brand_checker.py check --file copy.txt`

Script Quick Reference

Generate and validate UTMs:

# 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

Check brand compliance:

# 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
python scripts/brand_checker.py banned --file email_draft.txt

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

Workflow Decision Tree

What does the user need?

Creating or planning content?
├─ Yes → content-strategy.md
│        • Topic clusters, pillar pages
│        • Content calendars (annual/quarterly/weekly)
│        • TOFU/MOFU/BOFU mapping
│        • Repurposing workflows
└─ No ↓

Platform-specific social guidance?
├─ Yes → social-media.md
│        • Instagram, LinkedIn, TikTok, X, Facebook
│        • Posting cadence and timing
│        • Algorithm priorities
│        • Engagement benchmarks
└─ No ↓

Email campaigns or sequences?
├─ Yes → email-marketing.md
│        • Welcome, drip, re-engagement sequences
│        • Subject line optimization
│        • Segmentation strategies
│        • Deliverability requirements
└─ No ↓

UTM parameters or tracking URLs?
├─ Yes → utm-tracking.md + scripts/utm_tools.py
│        • Parameter formatting rules
│        • Naming conventions
│        • GA4 channel alignment
│        • Dynamic parameters for ads
│        • Batch URL generation
└─ No ↓

Analytics, metrics, or reporting?
├─ Yes → analytics-measurement.md
│        • KPIs by channel
│        • GA4 configuration checklist
│        • Attribution models
│        • ROI formulas
└─ No ↓

Product launch or go-to-market?
├─ Yes → gtm-tools.md
│        • SOSTAC, RACE, AARRR frameworks
│        • Launch campaign structure
│        • Positioning methodology
│        • Marketing tool selection
└─ No ↓

Brand voice, tone, or messaging?
├─ Yes → brand-guidelines.md + scripts/brand_checker.py
│        • Voice dimension matrix
│        • This-but-not-that chart
│        • Messaging framework
│        • Terminology standards
│        • Compliance checking
└─ No ↓

SEO or search engine optimization?
├─ Yes → seo-optimization.md
│        • Technical SEO (crawling, indexing, speed)
│        • On-page SEO (titles, headers, content)
│        • Content SEO (E-E-A-T, topic clusters)
│        • Link building strategies
│        • Core Web Vitals
└─ No ↓

AI visibility, GEO, or chatbot optimization?
├─ Yes → geo-optimization.md
│        • Generative Engine Optimization (GEO)
│        • LLMO (Large Language Model Optimization)
│        • AEO (Answer Engine Optimization)
│        • ChatGPT, Perplexity, AI Overviews visibility
│        • Content structure for AI citation
└─ No → Clarify the specific marketing need

Multi-Domain Loading Order

For requests spanning multiple domains, load references in priority order:

Request Type	Primary	Secondary	Supporting
Product launch	gtm-tools.md	brand-guidelines.md, content-strategy.md	email-marketing.md, social-media.md
Campaign tracking	utm-tracking.md	analytics-measurement.md	—
Quarterly plan	content-strategy.md	social-media.md, email-marketing.md	analytics-measurement.md
Performance optimization	analytics-measurement.md	(channel-specific)	—
Brand voice	brand-guidelines.md	brand_checker.py	—
Search rankings	seo-optimization.md	content-strategy.md	analytics-measurement.md
AI visibility	geo-optimization.md	seo-optimization.md	content-strategy.md
Full strategy	seo-optimization.md, geo-optimization.md	content-strategy.md, social-media.md	email-marketing.md, analytics-measurement.md

Campaign Validation Checklist

Before launching any campaign, verify:

Strategy

Target audience clearly defined
Campaign goals documented with baseline metrics
Success criteria established (KPIs + targets)
Timeline and milestones set

Tracking

UTM parameters validated (lowercase, hyphens, no spaces)
GA4 channel alignment confirmed
Conversion tracking tested
Attribution model selected

Content

Brand voice checklist completed
No banned words or unsubstantiated claims
Readability score acceptable (60+ Flesch)
CTA clear and actionable

Technical

Email sequences tested in preview
Links verified working
Mobile responsiveness checked
Analytics tracking confirmed

Persona Adaptation

Beginner signals: Asks "what is," "how do I," "why should I," unfamiliar terminology, requests explanations. → Provide concept context before tactics. Explain frameworks. Offer templates.

Experienced signals: Uses correct terminology, asks for benchmarks, requests templates, mentions specific tools. → Skip fundamentals. Provide benchmarks, templates, advanced tactics directly.

Boundaries

In scope:

Campaign strategy and planning
Content calendars and topic clusters
Social media tactics and scheduling guidance
Email sequences and copy frameworks
UTM parameter generation and governance
Marketing analytics and KPI frameworks
Go-to-market planning and positioning
Marketing tool recommendations
Brand voice and messaging frameworks
Copy compliance checking
SEO optimization (technical, on-page, content, E-E-A-T)
GEO/AI visibility optimization (ChatGPT, Perplexity, AI Overviews)

Out of scope (suggest alternatives):

Paid ad campaign management (bid strategies, audience targeting)
CRM workflow implementation
Website design/development
Brand identity design (logos, colors, visual design)
PR and media relations
General copywriting (not campaign-specific)

Clarify before proceeding:

"Help with marketing" → Which domain?
"Improve my ads" → Creative/copy (in scope) or campaign management (out of scope)?
"Analytics setup" → Marketing analytics or general web analytics?
"Brand guidelines" → Voice/messaging (in scope) or visual identity (out of scope)?

README

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

Download or clone this repository
Copy the contents to ~/.claude/skills/running-marketing-campaigns/
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:

Fork the repository
Create a feature branch
Make your changes
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

View on SkillzWave Marketplace

SkillzWave.ai - Largest Agentic Marketplace for AI Agent Skills
SpillWave - Leaders in AI Agent Development

running-marketing-campaigns

SKILL.md

Marketing Campaign Execution

Contents

Quick Start

Generate UTM Parameters

Create Email Sequence

Plan Content Calendar

Check Campaign Performance

Domain Reference Guide

Scripts

Script Quick Reference

Workflow Decision Tree

Multi-Domain Loading Order

Campaign Validation Checklist

Strategy

Tracking

Content

Technical

Persona Adaptation

Boundaries

README

Running Marketing Campaigns - Claude Agent Skill

Quick Start

Features

Installing with Skilz (Universal Installer)

Install Skilz

Git URL Options

Claude Code

OpenCode

Gemini

OpenAI Codex

Install from Skillzwave Marketplace

Other Supported Agents

Manual Installation

Claude Code

Other Methods

Usage

Example Prompts

Scripts

utm_tools.py

brand_checker.py

Structure

Reference Guides

Brand Voice Features

Voice Dimensions Matrix

This-But-Not-That Chart

Banned Words Detection

Requirements

License

Contributing

Related Resources