claude-marketing
githubA full marketing department for Claude Code. Skill packs for Klaviyo, Shopify, GA4, Looker Studio, paid media, and more. Audit, optimize, and report using natural language.
claude-marketing contains 56 open-source Claude Code skills, specialized agents, and autonomous workflows for marketing teams. Paid media, e-commerce, content, strategy, creative, reporting, and development — specialist depth without specialist headcount.
git clone https://github.com/thatrebeccarae/claude-marketing.git
Works on Mac, Windows, and Linux.
Quick Start · Skills · Skill Packs · Agents · Workflows · Multi-Tool Support · How Skills Work · Composing Skills · Example Prompts · Configuration · Contributing · License
56 open-source skills that give Claude Code real marketing expertise — diagnostic frameworks, industry benchmarks, audit checklists, and platform-specific reference data across paid media, SEO, e-commerce, content, CRO, analytics, and strategy. Also works with Cursor, Aider, Windsurf, GitHub Copilot, and Gemini CLI.
Each skill ships three layers: SKILL.md (frameworks and decision trees), REFERENCE.md (benchmarks, API schemas, rate limits), and EXAMPLES.md (worked prompts with expected output). Not prompt templates — implementation-grade tools tested in real engagements.
The catalog came out of a client engagement where the team was drowning in meetings and grew from there. The companion essay on dgtl dept* walks through three of the skills with the exact prompts I run on live engagements, the output they return, and what they replace.
For installing and using them properly, the Claude Marketing — The Complete Guide is the deeper reference — free, in Notion, six pages on install, credentials, the six skills to start with, how the scored audits work, five workflow chains I run on engagements, and the n8n pipeline build. Read it before you start, or keep it open on a second monitor while you work.
Quick Start
# Clone the repo
git clone https://github.com/thatrebeccarae/claude-marketing.git
# Copy any skill
cp -r claude-marketing/skills/google-ads ~/.claude/skills/
# Or install a full pack
python claude-marketing/skill-packs/scripts/setup-paid-media.py
# Then ask Claude Code anything
# "Run a scored audit of my Google Ads account"
# "Audit my Klaviyo flows and tell me what's missing"
# "Optimize this page for AI search citations"
Each skill works independently — install only what you need.
What’s Inside
| Category | What It Is | Count |
|---|---|---|
| Skills | Claude Code skills — install individually or as packs | 56 skills |
| Skill Packs | Grouped collections with setup guides and install wizards | 6 packs |
| Examples | Cross-skill workflow walkthroughs showing how skills compose | 3 workflows |
| Agents | Standalone agents — portable analysis logic, usable with or without n8n | 3 agents |
| Workflows | Autonomous n8n pipelines that wire agents together on a schedule | 1 pipeline |
Skills
All 56 skills live in skills/ — install individually or use a skill pack to set up a related group. The interactive demo site has search, skill details, and install instructions for each.
All skills tested March 2026 with Claude Code v2.1. Each skill’s SKILL.md includes a
testeddate andtested_withversion in its frontmatter metadata.
Paid Media
| Skill | What Claude Can Do |
|---|---|
| Google Ads | Scored account audits (74 checks, A-F health grade), Quality Score optimization, Performance Max, Shopping, bidding strategies, wasted spend identification |
| Meta Ads | Scored account audits (46 checks, A-F health grade), creative fatigue diagnosis, pixel/CAPI health, iOS 14.5+ attribution, Advantage+ readiness |
| Microsoft Ads | Scored account audits (30 checks, A-F health grade), Google import optimization, LinkedIn Profile Targeting, UET tracking, Clarity integration |
| LinkedIn Ads | B2B advertising — campaign setup, professional targeting, Lead Gen Forms, ABM campaigns, Matched Audiences |
| TikTok Ads | Short-form video ads — Spark Ads, TikTok Shop, creative strategy, pixel/Events API, audience targeting |
| Cross-Platform Audit | Unified multi-platform scored audit — parallel execution across Google, Meta, and Microsoft with budget-weighted aggregate health score (A-F) |
| Account Structure Review | Cross-platform structural audit — conversion volume thresholds, budget fragmentation, consolidation roadmaps |
| Competitor Ads Analyst | Competitor ad creative analysis from public ad libraries — messaging patterns, creative formats, positioning gaps |
| Wasted Spend Finder | Systematic Google Ads and Meta waste analysis — produces uploadable exclusion lists with thematic categorization |
SEO & AI Search
| Skill | What Claude Can Do |
|---|---|
| AEO/GEO Optimizer | AI search optimization — appear in ChatGPT, Perplexity, Google AI Overviews. Content scoring, citation patterns, AI crawler management |
| Technical SEO Audit | Deep crawl analysis, Core Web Vitals, indexation health, site architecture, canonical tags, structured data validation |
| Schema Markup Generator | JSON-LD structured data — Article, FAQ, HowTo, Product, Review, LocalBusiness, BreadcrumbList |
| Programmatic SEO | Template-based page generation at scale — integration pages, location pages, comparison pages, internal linking |
| SEO Content Writer | SEO-optimized content with brand voice analysis — blog posts, social media, email campaigns, landing pages |
| llms.txt | Generate llms.txt files for AI discoverability — helps answer engines surface your project accurately |
Content
| Skill | What Claude Can Do |
|---|---|
| Content Creator | Brand voice analysis, SEO optimization scripts, content calendar planning, multi-platform strategy |
| Copywriting Frameworks | AIDA, PAS, BAB, 4Ps, StoryBrand, QUEST, FAB — framework-driven copy for ads, pages, emails |
| Social Media Strategy | Platform-specific organic strategy, content pillar framework, engagement tactics, content calendars |
| Email Composer | Client outreach, deliverable handoffs, scope discussions, and follow-up cadence — with tone calibration per context |
| Content Pipeline | Multi-agent orchestration — chains research, editorial review, and social distribution agents in sequence |
| Content Workflow | End-to-end content pipeline: research → draft → editorial review → social distribution |
Growth & Conversion
| Skill | What Claude Can Do |
|---|---|
| CRO Auditor | Conversion rate optimization — LIFT model heuristic evaluation, ICE/PIE prioritization, A/B test hypothesis generation |
| Landing Page Optimizer | Page audit and optimization — above-the-fold, value props, CTAs, social proof, forms, mobile |
| A/B Testing Framework | Experiment design, sample size calculation, statistical significance, Bayesian vs frequentist analysis |
| Retention & Churn Prevention | Churn analysis, customer health scoring, cohort analysis, win-back campaigns, CLV calculation |
Strategy & Research
| Skill | What Claude Can Do |
|---|---|
| Brand DNA | Extract brand identity from a URL — voice, colors, typography, imagery, values, audience — into brand-profile.json for downstream skill consumption |
| Brand Voice & Guidelines | Voice development, personality archetypes, tone matrices, messaging frameworks, style guides |
| Market Research | Consulting-grade research reports (50+ pages) — Porter’s Five Forces, PESTLE, SWOT, TAM/SAM/SOM, competitive positioning |
| ICP Research | Ideal customer profiles with pain points, objections, buying triggers, community research, and voice-of-customer extraction |
| Customer Journey Mapping | Journey stage mapping, touchpoint inventory, drop-off analysis, persona-based journey variants |
| Pricing Strategy | Pricing models, value metric selection, competitive analysis, pricing page optimization, tier design |
| Research Digest | Structured research briefs from RSS feeds and web sources — source synthesis, credibility assessment, content angles |
| Cold Email & Outreach | Outbound prospecting sequences, deliverability optimization, personalization tiers, CAN-SPAM/GDPR compliance |
Email & Lifecycle
| Skill | What Claude Can Do |
|---|---|
| Klaviyo Analyst (MCP-first) | Full Klaviyo audit — 4-phase account review, flow gap analysis, segment health, deliverability diagnostics, revenue attribution with industry benchmarks. Built around the official Klaviyo MCP server. |
| Klaviyo Developer | Event schema design, SDK integration, webhook handling, rate limit strategy, catalog sync. MCP-aware for exploration; SDK-first for production integrations. |
| Braze | Canvas audit, segmentation, cross-channel orchestration, data architecture, deliverability, IP warming |
Analytics
| Skill | What Claude Can Do |
|---|---|
| Google Analytics | GA4 traffic analysis, channel comparison, conversion funnels, content performance |
| Google Tag Manager | Container audits, consent mode v2, server-side tagging, debugging, tag architecture |
| Looker Studio | Cross-platform dashboards via Google Sheets pipeline, DTC dashboard templates, calculated field library |
| Shopify | 12-step store audit, conversion funnel analysis, site speed diagnostics, marketing stack integration |
| UTM & Attribution Strategy | UTM taxonomy design, attribution model selection, cross-channel measurement, GA4 attribution configuration |
Creative & Design
| Skill | What Claude Can Do |
|---|---|
| Frontend Design | Distinctive, production-grade web interfaces — typography, color theory, motion, spatial composition. Commits to a specific aesthetic direction, not generic defaults. |
| Tech Diagram | Technical architecture diagrams as standalone HTML — pipeline flows, layer stacks, component maps, timelines |
| Remotion Video | Programmatic video production — spring animations, chart animations, scene transitions, audio sync |
Reporting & Deliverables
| Skill | What Claude Can Do |
|---|---|
| Pro Deck Builder | Polished HTML slide decks and PDF-ready reports — dark covers, warm light content, component library |
| Pro Report Builder | HTML consulting reports — dark cover, warm cream pages, KPI cards, data tables, recommendation cards, PDF export |
| HTML Report Builder | Multi-page HTML reports for consulting deliverables — KPI cards, data tables, callout boxes, recommendation cards |
| Data Viz Deck | PPTX decks, interactive HTML dashboards, and chart generation from audit data |
DevOps
| Skill | What Claude Can Do |
|---|---|
| GitHub README | Project-type-aware README generation, audit (scored 0-100), and update — with voice calibration and SEO/AEO discoverability guidance |
| Repo Health | One-command repo health audit — checks standard files, GitHub config, branch protection, documentation quality |
| Repo Scaffold | Initialize repos with standard files — LICENSE, CONTRIBUTING, SECURITY, issue/PR templates, CI config |
| Sync Repos | Manage public/private repo pairs — verify parity, detect drift, run sync scripts, validate no data leaks |
| Dep Audit | Cross-repo dependency audit — outdated packages, security advisories, version conflicts, license issues |
| Release Notes | Generate changelogs and GitHub releases from git history — conventional commits, PR grouping, semver |
| Social Preview | Generate OG social preview images (1280x640) for GitHub repos — branded templates, dark/light themes |
| Safe Push | Pre-push hygiene — PII/secrets scanning, commit message audit, rate-limited pushing, allowlist support |
Skill Packs
Grouped collections with setup wizards for installing related skills together:
- Content Pack — 3 skills for SEO content, editorial pipelines, and client communication. (seo-content-writer, content-workflow, email-composer)
- Creative & Design Pack — 3 skills for frontend interfaces, technical diagrams, and programmatic video. (frontend-design, tech-diagram, remotion-video)
- Developer Tools Pack — 2 skills for pre-push security scanning and README generation. (safe-push, github-readme)
- DTC Skill Pack — 6 skills that give Claude Code deep expertise in DTC e-commerce marketing. (klaviyo-analyst, klaviyo-developer, shopify, google-analytics, looker-studio, pro-deck-builder)
- Paid Media Pack — 6 skills for cross-platform paid media — Google Ads, Meta Ads, Microsoft Ads, competitive analysis, waste detection, and account structure review. (google-ads, facebook-ads, microsoft-ads, competitor-ads-analyst, wasted-spend-finder, account-structure-review)
- Strategy & Research Pack — 3 skills for market research, ICP development, and research synthesis. (market-research, icp-research, research-digest)
Multi-Tool Support
Skills work with 5 AI coding tools beyond Claude Code — Cursor, Aider, Windsurf, GitHub Copilot, and Gemini CLI. Run install.sh for interactive setup, or follow the per-tool instructions below.
Quick Install
bash scripts/install.sh
Auto-detects your installed tools, lets you choose which to install for.
Per-Tool Quick-Start
Cursor — One rule file per skill, auto-suggested by Cursor agent.
cp integrations/cursor/*.mdc your-project/.cursor/rules/
Aider — Skills load every session via config.
cp integrations/aider/CONVENTIONS.md your-project/
echo "read: CONVENTIONS.md" >> your-project/.aider.conf.yml
Windsurf — All skills in one file, always active.
cp integrations/windsurf/.windsurfrules your-project/
GitHub Copilot — Works in VS Code and on GitHub.com.
cp integrations/copilot/*.instructions.md your-project/.github/instructions/
Gemini CLI — Modular loading via @import.
cp -r integrations/gemini/* your-project/
Compatibility Matrix
Not all skill content translates across formats — some tools have size limits or don’t support file references.
| Content | Claude Code | Cursor | Aider | Windsurf | Copilot | Gemini CLI |
|---|---|---|---|---|---|---|
| Core capabilities | Full | Full | Summary | Summary | Full | Full |
| Reference data | Full | Partial | — | — | — | Full (@import) |
| Examples | Full | — | — | — | — | Optional |
| Install command | Full | — | — | — | — | — |
Advanced Usage
To regenerate integrations/ after editing skills:
bash scripts/convert.sh
See CONTRIBUTING.md for adding new skills and keeping converted output in sync.
How Skills Work
A Claude Code skill is a structured domain expertise file that loads into Claude automatically when invoked. Each skill contains diagnostic frameworks, industry benchmarks, and platform-specific reference data that Claude doesn’t have out of the box — the kind of context that turns a general-purpose AI into a specialist.
What a Skill Contains
| File | Purpose |
|---|---|
| SKILL.md | Frontmatter + instructions Claude reads at invocation — frameworks, decision trees, diagnostic patterns |
| REFERENCE.md | Platform-specific data: industry benchmarks, API schemas, field mappings, rate limits |
| EXAMPLES.md | Working examples with realistic prompts and expected output format |
| scripts/ | Utility scripts for setup, data fetching, health checks (where applicable) |
How Claude Uses Them
- You ask a question in natural language (e.g., “Audit my Klaviyo flows”)
- Claude loads the relevant skill’s SKILL.md, which contains the diagnostic framework
- Claude references REFERENCE.md for benchmarks, thresholds, and platform-specific data
- If an MCP server is configured (e.g., Klaviyo), Claude pulls live data from your account
- Claude delivers structured analysis with specific recommendations — not generic advice
[!NOTE] Skills work without MCP servers too. You can paste data, share screenshots, or use the included scripts to export data manually. The MCP server just makes it seamless.
Agents and Workflows
Agents are standalone analysis modules with portable logic — comparison engines, prompt builders, response parsers. Each agent works independently and can be used without n8n.
Workflows are autonomous n8n pipelines that wire agents together on a schedule. n8n runs locally here to save on costs, but cloud hosting works too. Unlike skills (which respond when you ask), workflows run on a schedule and act independently.
Workflows use Claude via the Anthropic API (not Claude Code) — Claude Opus 4.6 with adaptive thinking for deep analysis, Claude Haiku 4.5 for fast classification.
Agents
Standalone agents with portable analysis logic — usable independently or wired together by a workflow.
| Agent | What It Does |
|---|---|
| GA4 Monitor | Compares GA4 event data against a tracking spec, flags gaps, unexpected events, and volume anomalies |
| GA4 Gap Analyzer | Claude diagnoses tracking gaps (Opus 4.6 + adaptive thinking) and anomalies (Haiku 4.5), generates GTM implementation specs. Optional AEO awareness recommends an ai_referral event when client config sets aeo_tracking_enabled: true. |
| GTM Implementer | Creates GTM variables, triggers, and tags — rate-limited, idempotent, workspace-isolated |
Each agent works independently. Use GA4 Monitor for one-time audits without Claude or GTM. Use GA4 Gap Analyzer to diagnose issues from any comparison data. Use GTM Implementer to provision resources from any spec.
Workflows
Autonomous n8n pipelines that wire agents together on a schedule. They monitor, analyze, and act — then notify you with results.
GA4-GTM Pipeline — Daily GA4 monitoring + GTM implementation
GA4 tracking gaps cost you conversion data every day. This pipeline detects them automatically and patches them in GTM.
| Stage | Agent | What Happens |
|---|---|---|
| Monitor | GA4 Monitor | Fetches all GA4 events daily, compares against your event spec |
| Analyze | GA4 Gap Analyzer | Claude Opus (with adaptive thinking) identifies gaps and recommends GTM implementations; Claude Haiku diagnoses anomalies |
| Implement | GTM Implementer | Creates GTM variables, triggers, and tags in an isolated workspace (unpublished until you review) |
| Notify | — | Slack messages at every stage — all-clear, gaps found, anomalies detected, GTM resources created |
Handles multiple GA4 properties — configure once per property, runs hands-off from there.
See the GA4-GTM Pipeline README for the architecture overview, or the Complete Guide for the full n8n build walkthrough.
Composing Skills
Skills are most powerful when chained together — each skill’s output becomes context for the next. See the full composing guide for how context flows between skills.
| Workflow | Skills Chained | What You Get |
|---|---|---|
| DTC Account Audit | ICP Research → Klaviyo Analyst → Google Analytics → Pro Deck Builder | Client-ready audit deck in ~45 min |
| Paid Media Optimization | Wasted Spend Finder → Competitor Ads Analyst → Google Ads → Account Structure Review | Exclusion lists + restructuring roadmap |
| Content Production | Research Digest → ICP Research → SEO Content Writer → Content Workflow | SEO article + social distribution pack |
Example Prompts
Email & Lifecycle
"Audit my Klaviyo flows and identify which essential flows I'm missing"
"My checkout completion rate is 31% — what's causing the drop-off?"
"Which traffic sources are driving the most conversions this month?"
Paid Media
"Analyze my Google Ads search terms and find wasted spend"
"Pull competitor ads from Meta Ad Library for these 3 brands and find messaging gaps"
"Run a full cross-platform audit across Google, Meta, and Microsoft — give me a unified health score and deck"
Content & Strategy
"Build an ICP for our SaaS product targeting VP of Marketing at mid-market companies"
"Write a 1,500-word SEO article targeting 'email marketing benchmarks for DTC brands'"
"Generate a research brief on AI in email marketing from the last 30 days"
Creative & Reporting
"Create a dark-mode deck summarizing this month's email performance"
"Build an HTML audit report from these Klaviyo metrics"
"Design a landing page for our analytics product — editorial aesthetic, not typical SaaS"
Developer Tools
"Audit this repo's README and score it"
"Run a health check across all my public repos"
"Scaffold a new repo with standard files and CI config"
"Generate release notes from the last 20 commits"
"Check for outdated dependencies across all my Node projects"
Configuration
Setup Wizard Options
| Flag | What It Does |
|---|---|
python scripts/setup.py | Full interactive setup |
--skip-install | Skip dependency installation |
--skills klaviyo,shopify | Install specific skills only |
--non-interactive | Use environment variables, skip prompts |
API Keys by Platform
| Platform | Key Required | Where to Get It |
|---|---|---|
| Klaviyo | Private API Key (pk_...) | Klaviyo > Settings > API Keys |
| Google Analytics | Service account JSON + Property ID | Google Cloud Console > IAM > Service Accounts |
| Shopify | Admin API access token | Shopify Admin > Apps > Develop Apps |
| Looker Studio | Google Sheets API credentials | Google Cloud Console > APIs & Services |
[!IMPORTANT] API keys are stored in
.envfiles which are gitignored by default. Never hardcode keys in skill files or commit them to version control. See SECURITY.md for full credential handling guidance.
Klaviyo MCP server setup
The official Klaviyo MCP server gives Claude direct access to your Klaviyo account. The setup path depends on which Claude surface you’re using.
Option A — Claude Chat or Cowork (Connector Directory, ~2 min)
Klaviyo is in Claude’s Connector Directory as of the expanded Klaviyo + Anthropic integration (announced 2026-05-07). Setup is:
- Open Claude → Settings → Connectors → Browse Connectors
- Search for Klaviyo
- Click Connect and authenticate
Available on Claude Pro, Max, Team, and Enterprise plans. Free plan users need to use Claude Code or the local install path below.
Option B — Claude Code (remote MCP)
claude mcp add klaviyo --transport http https://mcp.klaviyo.com/mcp
For audit-only sessions:
claude mcp add klaviyo --transport http "https://mcp.klaviyo.com/mcp?read-only=true"
Option C — Local MCP via uvx (CI containers, offline development)
- Install uv:
curl -LsSf https://astral.sh/uv/install.sh | sh - Add to
~/.mcp.json:
{
"mcpServers": {
"klaviyo": {
"command": "uvx",
"args": ["klaviyo-mcp-server@latest"],
"env": {
"PRIVATE_API_KEY": "${KLAVIYO_API_KEY}",
"READ_ONLY": "true",
"ALLOW_USER_GENERATED_CONTENT": "false"
}
}
}
}
- Restart Claude Code and verify with
/mcp
Klaviyo-side requirement: Owner, Admin, or Manager role to authorize the connection (any option above).
All three options expose the same 40+ tools across Accounts, Campaigns, Catalogs, Events, Flows, Groups, Profiles, Reporting, Templates, and Translations. See the klaviyo-analyst REFERENCE for the full tool inventory. See the DTC Pack guide for recommended Klaviyo API scopes when using the local option.
Security
All scripts include input validation, path sanitization, SSRF protection, and secure credential handling. Key principles:
- API keys stored in
.envfiles (gitignored), never hardcoded - Read-only API access by default — write scopes are opt-in
- No PII extraction — skills work with aggregates, not individual customer data
- No persistent storage — analysis runs in-memory, output goes to local files you control
For vulnerability reporting and full security design details, see SECURITY.md.
Troubleshooting
Skills not loading in Claude Code
- Verify skills are in the right directory:
ls ~/.claude/skills/ - Each skill folder should contain at least a
SKILL.mdfile - Restart Claude Code after copying skills
- Check that SKILL.md frontmatter is valid YAML
API key errors
- Confirm your
.envfile is in the project root (not inside a skill folder) - Klaviyo keys must start with
pk_— if yours doesn’t, you may have copied a public key - Google service account JSON path must be absolute, not relative
- Run
python scripts/setup.pyto re-validate all keys
Python version issues
The setup wizard requires Python 3.8+. Check your version:
python --version
# or
python3 --version
On macOS, python may point to Python 2. Use python3 explicitly or install via Homebrew: brew install python
MCP server not connecting
- Verify
~/.mcp.jsonsyntax is valid JSON (no trailing commas) - Confirm
uvis installed:uv --version - Check that your
KLAVIYO_API_KEYenvironment variable is set:echo $KLAVIYO_API_KEY - Restart Claude Code — MCP servers load at startup
Documentation
Skill Packs
| Pack | Skills | Description |
|---|---|---|
| Content Pack | 3 | 3 skills for SEO content, editorial pipelines, and client communication. |
| Creative & Design Pack | 3 | 3 skills for frontend interfaces, technical diagrams, and programmatic video. |
| Developer Tools Pack | 2 | 2 skills for pre-push security scanning and README generation. |
| DTC Skill Pack | 6 | 6 skills that give Claude Code deep expertise in DTC e-commerce marketing. |
| Paid Media Pack | 6 | 6 skills for cross-platform paid media — Google Ads, Meta Ads, Microsoft Ads, competitive analysis, waste detection, and account structure review. |
| Strategy & Research Pack | 3 | 3 skills for market research, ICP development, and research synthesis. |
Other Resources
| Resource | Description |
|---|---|
| The Marketing Expertise Layer for Claude Code | Companion essay on dgtl dept* — three skills walked end-to-end with the prompts I actually type |
| Claude Marketing — The Complete Guide | Free Notion reference. Six pages: install, credentials, six skills to start with, scored audits explained, five workflow chains, the n8n pipeline build, troubleshooting |
| Composing Skills | How to chain skills together — context flow, tips, and 3 worked workflow examples |
| DTC Getting Started | Step-by-step setup for DTC platforms |
| Paid Media Getting Started | Step-by-step setup for paid media platforms |
| GA4-GTM Pipeline README | Pipeline architecture, agent orchestration, setup, and security model |
| CHANGELOG | Version history and release notes |
| SECURITY | Security design and vulnerability reporting |
| CONTRIBUTING | How to contribute skills, report bugs, submit PRs |
Contributing
Contributions are welcome — bug reports, documentation fixes, skill suggestions, and new skills. See CONTRIBUTING.md for guidelines on submitting skills, the required file structure, and the PR process.
License
MIT — see LICENSE for details.
The expertise layer your AI agent is missing.
git clone it. Install what you need. Ask in plain English.
Please don’t be a jerk and steal my work.