Claude Code Tools

claude-marketing

github

A 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.

Stars
⭐ 37
License
MIT
Last Updated
2026-05-20
Source
github
claude-marketing — The marketing experience layer for Claude Code

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.



Claude Code LinkedIn X Substack Website GitHub stars License Clone


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.

Get the Complete Guide

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

CategoryWhat It IsCount
SkillsClaude Code skills — install individually or as packs56 skills
Skill PacksGrouped collections with setup guides and install wizards6 packs
ExamplesCross-skill workflow walkthroughs showing how skills compose3 workflows
AgentsStandalone agents — portable analysis logic, usable with or without n8n3 agents
WorkflowsAutonomous n8n pipelines that wire agents together on a schedule1 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 tested date and tested_with version in its frontmatter metadata.

View Catalog

SkillWhat Claude Can Do
Google AdsScored account audits (74 checks, A-F health grade), Quality Score optimization, Performance Max, Shopping, bidding strategies, wasted spend identification
Meta AdsScored account audits (46 checks, A-F health grade), creative fatigue diagnosis, pixel/CAPI health, iOS 14.5+ attribution, Advantage+ readiness
Microsoft AdsScored account audits (30 checks, A-F health grade), Google import optimization, LinkedIn Profile Targeting, UET tracking, Clarity integration
LinkedIn AdsB2B advertising — campaign setup, professional targeting, Lead Gen Forms, ABM campaigns, Matched Audiences
TikTok AdsShort-form video ads — Spark Ads, TikTok Shop, creative strategy, pixel/Events API, audience targeting
Cross-Platform AuditUnified multi-platform scored audit — parallel execution across Google, Meta, and Microsoft with budget-weighted aggregate health score (A-F)
Account Structure ReviewCross-platform structural audit — conversion volume thresholds, budget fragmentation, consolidation roadmaps
Competitor Ads AnalystCompetitor ad creative analysis from public ad libraries — messaging patterns, creative formats, positioning gaps
Wasted Spend FinderSystematic Google Ads and Meta waste analysis — produces uploadable exclusion lists with thematic categorization
SkillWhat Claude Can Do
AEO/GEO OptimizerAI search optimization — appear in ChatGPT, Perplexity, Google AI Overviews. Content scoring, citation patterns, AI crawler management
Technical SEO AuditDeep crawl analysis, Core Web Vitals, indexation health, site architecture, canonical tags, structured data validation
Schema Markup GeneratorJSON-LD structured data — Article, FAQ, HowTo, Product, Review, LocalBusiness, BreadcrumbList
Programmatic SEOTemplate-based page generation at scale — integration pages, location pages, comparison pages, internal linking
SEO Content WriterSEO-optimized content with brand voice analysis — blog posts, social media, email campaigns, landing pages
llms.txtGenerate llms.txt files for AI discoverability — helps answer engines surface your project accurately

Content

SkillWhat Claude Can Do
Content CreatorBrand voice analysis, SEO optimization scripts, content calendar planning, multi-platform strategy
Copywriting FrameworksAIDA, PAS, BAB, 4Ps, StoryBrand, QUEST, FAB — framework-driven copy for ads, pages, emails
Social Media StrategyPlatform-specific organic strategy, content pillar framework, engagement tactics, content calendars
Email ComposerClient outreach, deliverable handoffs, scope discussions, and follow-up cadence — with tone calibration per context
Content PipelineMulti-agent orchestration — chains research, editorial review, and social distribution agents in sequence
Content WorkflowEnd-to-end content pipeline: research → draft → editorial review → social distribution

Growth & Conversion

SkillWhat Claude Can Do
CRO AuditorConversion rate optimization — LIFT model heuristic evaluation, ICE/PIE prioritization, A/B test hypothesis generation
Landing Page OptimizerPage audit and optimization — above-the-fold, value props, CTAs, social proof, forms, mobile
A/B Testing FrameworkExperiment design, sample size calculation, statistical significance, Bayesian vs frequentist analysis
Retention & Churn PreventionChurn analysis, customer health scoring, cohort analysis, win-back campaigns, CLV calculation

Strategy & Research

SkillWhat Claude Can Do
Brand DNAExtract brand identity from a URL — voice, colors, typography, imagery, values, audience — into brand-profile.json for downstream skill consumption
Brand Voice & GuidelinesVoice development, personality archetypes, tone matrices, messaging frameworks, style guides
Market ResearchConsulting-grade research reports (50+ pages) — Porter’s Five Forces, PESTLE, SWOT, TAM/SAM/SOM, competitive positioning
ICP ResearchIdeal customer profiles with pain points, objections, buying triggers, community research, and voice-of-customer extraction
Customer Journey MappingJourney stage mapping, touchpoint inventory, drop-off analysis, persona-based journey variants
Pricing StrategyPricing models, value metric selection, competitive analysis, pricing page optimization, tier design
Research DigestStructured research briefs from RSS feeds and web sources — source synthesis, credibility assessment, content angles
Cold Email & OutreachOutbound prospecting sequences, deliverability optimization, personalization tiers, CAN-SPAM/GDPR compliance

Email & Lifecycle

SkillWhat 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 DeveloperEvent schema design, SDK integration, webhook handling, rate limit strategy, catalog sync. MCP-aware for exploration; SDK-first for production integrations.
BrazeCanvas audit, segmentation, cross-channel orchestration, data architecture, deliverability, IP warming

Analytics

SkillWhat Claude Can Do
Google AnalyticsGA4 traffic analysis, channel comparison, conversion funnels, content performance
Google Tag ManagerContainer audits, consent mode v2, server-side tagging, debugging, tag architecture
Looker StudioCross-platform dashboards via Google Sheets pipeline, DTC dashboard templates, calculated field library
Shopify12-step store audit, conversion funnel analysis, site speed diagnostics, marketing stack integration
UTM & Attribution StrategyUTM taxonomy design, attribution model selection, cross-channel measurement, GA4 attribution configuration

Creative & Design

SkillWhat Claude Can Do
Frontend DesignDistinctive, production-grade web interfaces — typography, color theory, motion, spatial composition. Commits to a specific aesthetic direction, not generic defaults.
Tech DiagramTechnical architecture diagrams as standalone HTML — pipeline flows, layer stacks, component maps, timelines
Remotion VideoProgrammatic video production — spring animations, chart animations, scene transitions, audio sync

Reporting & Deliverables

SkillWhat Claude Can Do
Pro Deck BuilderPolished HTML slide decks and PDF-ready reports — dark covers, warm light content, component library
Pro Report BuilderHTML consulting reports — dark cover, warm cream pages, KPI cards, data tables, recommendation cards, PDF export
HTML Report BuilderMulti-page HTML reports for consulting deliverables — KPI cards, data tables, callout boxes, recommendation cards
Data Viz DeckPPTX decks, interactive HTML dashboards, and chart generation from audit data

DevOps

SkillWhat Claude Can Do
GitHub READMEProject-type-aware README generation, audit (scored 0-100), and update — with voice calibration and SEO/AEO discoverability guidance
Repo HealthOne-command repo health audit — checks standard files, GitHub config, branch protection, documentation quality
Repo ScaffoldInitialize repos with standard files — LICENSE, CONTRIBUTING, SECURITY, issue/PR templates, CI config
Sync ReposManage public/private repo pairs — verify parity, detect drift, run sync scripts, validate no data leaks
Dep AuditCross-repo dependency audit — outdated packages, security advisories, version conflicts, license issues
Release NotesGenerate changelogs and GitHub releases from git history — conventional commits, PR grouping, semver
Social PreviewGenerate OG social preview images (1280x640) for GitHub repos — branded templates, dark/light themes
Safe PushPre-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.

ContentClaude CodeCursorAiderWindsurfCopilotGemini CLI
Core capabilitiesFullFullSummarySummaryFullFull
Reference dataFullPartialFull (@import)
ExamplesFullOptional
Install commandFull

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

FilePurpose
SKILL.mdFrontmatter + instructions Claude reads at invocation — frameworks, decision trees, diagnostic patterns
REFERENCE.mdPlatform-specific data: industry benchmarks, API schemas, field mappings, rate limits
EXAMPLES.mdWorking examples with realistic prompts and expected output format
scripts/Utility scripts for setup, data fetching, health checks (where applicable)

How Claude Uses Them

  1. You ask a question in natural language (e.g., “Audit my Klaviyo flows”)
  2. Claude loads the relevant skill’s SKILL.md, which contains the diagnostic framework
  3. Claude references REFERENCE.md for benchmarks, thresholds, and platform-specific data
  4. If an MCP server is configured (e.g., Klaviyo), Claude pulls live data from your account
  5. 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.

AgentWhat It Does
GA4 MonitorCompares GA4 event data against a tracking spec, flags gaps, unexpected events, and volume anomalies
GA4 Gap AnalyzerClaude 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 ImplementerCreates 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.

StageAgentWhat Happens
MonitorGA4 MonitorFetches all GA4 events daily, compares against your event spec
AnalyzeGA4 Gap AnalyzerClaude Opus (with adaptive thinking) identifies gaps and recommends GTM implementations; Claude Haiku diagnoses anomalies
ImplementGTM ImplementerCreates GTM variables, triggers, and tags in an isolated workspace (unpublished until you review)
NotifySlack 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.

WorkflowSkills ChainedWhat You Get
DTC Account AuditICP Research → Klaviyo Analyst → Google Analytics → Pro Deck BuilderClient-ready audit deck in ~45 min
Paid Media OptimizationWasted Spend Finder → Competitor Ads Analyst → Google Ads → Account Structure ReviewExclusion lists + restructuring roadmap
Content ProductionResearch Digest → ICP Research → SEO Content Writer → Content WorkflowSEO 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?"
"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

FlagWhat It Does
python scripts/setup.pyFull interactive setup
--skip-installSkip dependency installation
--skills klaviyo,shopifyInstall specific skills only
--non-interactiveUse environment variables, skip prompts

API Keys by Platform

PlatformKey RequiredWhere to Get It
KlaviyoPrivate API Key (pk_...)Klaviyo > Settings > API Keys
Google AnalyticsService account JSON + Property IDGoogle Cloud Console > IAM > Service Accounts
ShopifyAdmin API access tokenShopify Admin > Apps > Develop Apps
Looker StudioGoogle Sheets API credentialsGoogle Cloud Console > APIs & Services

[!IMPORTANT] API keys are stored in .env files 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:

  1. Open Claude → Settings → Connectors → Browse Connectors
  2. Search for Klaviyo
  3. 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)

  1. Install uv: curl -LsSf https://astral.sh/uv/install.sh | sh
  2. 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"
      }
    }
  }
}
  1. 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 .env files (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
  1. Verify skills are in the right directory: ls ~/.claude/skills/
  2. Each skill folder should contain at least a SKILL.md file
  3. Restart Claude Code after copying skills
  4. Check that SKILL.md frontmatter is valid YAML
API key errors
  1. Confirm your .env file is in the project root (not inside a skill folder)
  2. Klaviyo keys must start with pk_ — if yours doesn’t, you may have copied a public key
  3. Google service account JSON path must be absolute, not relative
  4. Run python scripts/setup.py to 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
  1. Verify ~/.mcp.json syntax is valid JSON (no trailing commas)
  2. Confirm uv is installed: uv --version
  3. Check that your KLAVIYO_API_KEY environment variable is set: echo $KLAVIYO_API_KEY
  4. Restart Claude Code — MCP servers load at startup

Documentation

Skill Packs

PackSkillsDescription
Content Pack33 skills for SEO content, editorial pipelines, and client communication.
Creative & Design Pack33 skills for frontend interfaces, technical diagrams, and programmatic video.
Developer Tools Pack22 skills for pre-push security scanning and README generation.
DTC Skill Pack66 skills that give Claude Code deep expertise in DTC e-commerce marketing.
Paid Media Pack66 skills for cross-platform paid media — Google Ads, Meta Ads, Microsoft Ads, competitive analysis, waste detection, and account structure review.
Strategy & Research Pack33 skills for market research, ICP development, and research synthesis.

Other Resources

ResourceDescription
The Marketing Expertise Layer for Claude CodeCompanion essay on dgtl dept* — three skills walked end-to-end with the prompts I actually type
Claude Marketing — The Complete GuideFree Notion reference. Six pages: install, credentials, six skills to start with, scored audits explained, five workflow chains, the n8n pipeline build, troubleshooting
Composing SkillsHow to chain skills together — context flow, tips, and 3 worked workflow examples
DTC Getting StartedStep-by-step setup for DTC platforms
Paid Media Getting StartedStep-by-step setup for paid media platforms
GA4-GTM Pipeline READMEPipeline architecture, agent orchestration, setup, and security model
CHANGELOGVersion history and release notes
SECURITYSecurity design and vulnerability reporting
CONTRIBUTINGHow 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.