Skip to content
Back to search

claude-marketing

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.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/thatrebeccarae--claude-marketing/badge.svg)](/listings/thatrebeccarae--claude-marketing)

HTML

<a href="/listings/thatrebeccarae--claude-marketing"><img src="/api/listings/thatrebeccarae--claude-marketing/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

# 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 was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 580 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. <div align="center">
  2. <img src="assets/claude-marketing-hero.png" alt="claude-marketing — The marketing experience layer for Claude Code" width="100%">
  3. <br>
  4. <br>
  5. **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.
  6. <br>
  7. <br>
  8. [![Claude Code](https://img.shields.io/badge/Claude_Code-Tools-D97757?style=for-the-badge&logo=anthropic&logoColor=white)](https://docs.anthropic.com/en/docs/claude-code)
  9. [![LinkedIn](https://img.shields.io/badge/LinkedIn-Rebecca%20Rae%20Barton-0A66C2?style=for-the-badge&logo=linkedin&logoColor=white)](https://linkedin.com/in/rebeccaraebarton)
  10. [![X](https://img.shields.io/badge/X-@rebeccarae-000000?style=for-the-badge&logo=x&logoColor=white)](https://x.com/rebeccarae)
  11. [![Substack](https://img.shields.io/badge/Substack-claude--marketing-FF6719?style=for-the-badge&logo=substack&logoColor=white)](https://dgtldept.substack.com/welcome)
  12. [![Website](https://img.shields.io/badge/rebeccaraebarton.com-000000?style=for-the-badge&logo=google--chrome&logoColor=white)](https://rebeccaraebarton.com)
  13. [![GitHub stars](https://img.shields.io/github/stars/thatrebeccarae/claude-marketing?style=for-the-badge&logo=github&color=181717)](https://github.com/thatrebeccarae/claude-marketing/stargazers)
  14. [![License](https://img.shields.io/badge/License-MIT-353535?style=for-the-badge)](LICENSE)
  15. [![Clone](https://img.shields.io/badge/Clone-git%20clone-F05032?style=for-the-badge&logo=git&logoColor=white)](https://github.com/thatrebeccarae/claude-marketing)
  16. <br>
  17. ```bash
  18. git clone https://github.com/thatrebeccarae/claude-marketing.git
  19. ```
  20. <br>
  21. **Works on Mac, Windows, and Linux.**
  22. <br>
  23. <br>
  24. [Quick Start](#quick-start) · [Skills](#skills) · [Skill Packs](#skill-packs) · [Agents](#agents) · [Workflows](#workflows) · [Multi-Tool Support](#multi-tool-support) · [How Skills Work](#how-skills-work) · [Composing Skills](#composing-skills) · [Example Prompts](#example-prompts) · [Configuration](#configuration) · [Contributing](#contributing) · [License](#license)
  25. </div>
  26. ---
  27. 56 open-source skills that give [Claude Code](https://docs.anthropic.com/en/docs/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.
  28. 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.
  29. The catalog came out of [a client engagement where the team was drowning in meetings](https://dgtldept.substack.com/p/the-marketing-expertise-layer-for-claude-code) 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.
  30. For installing and using them properly, the [**Claude Marketing — The Complete Guide**](https://thatrebeccarae.kit.com/claude-marketing-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.
  31. <div align="center">
  32. [![Get the Complete Guide](https://img.shields.io/badge/Get_the_Complete_Guide-Free-353535?style=for-the-badge)](https://thatrebeccarae.kit.com/claude-marketing-guide)
  33. </div>
  34. ## Quick Start
  35. ```bash
  36. # Clone the repo
  37. git clone https://github.com/thatrebeccarae/claude-marketing.git
  38. # Copy any skill
  39. cp -r claude-marketing/skills/google-ads ~/.claude/skills/
  40. # Or install a full pack
  41. python claude-marketing/skill-packs/scripts/setup-paid-media.py
  42. # Then ask Claude Code anything
  43. # "Run a scored audit of my Google Ads account"
  44. # "Audit my Klaviyo flows and tell me what's missing"
  45. # "Optimize this page for AI search citations"
  46. ```
  47. Each skill works independently — install only what you need.
  48. ## What's Inside
  49. | Category | What It Is | Count |
  50. |----------|-----------|-------|
  51. | **[Skills](skills/)** | Claude Code skills — install individually or as packs | 56 skills |
  52. | **[Skill Packs](skill-packs/)** | Grouped collections with setup guides and install wizards | 6 packs |
  53. | **[Examples](examples/)** | Cross-skill workflow walkthroughs showing how skills compose | 3 workflows |
  54. | **[Agents](agents/)** | Standalone agents — portable analysis logic, usable with or without n8n | 3 agents |
  55. | **[Workflows](workflows/)** | Autonomous n8n pipelines that wire agents together on a schedule | 1 pipeline |
  56. ## Skills
  57. All 56 skills live in [`skills/`](skills/) — install individually or use a [skill pack](skill-packs/) to set up a related group. The interactive demo site has search, skill details, and install instructions for each.
  58. > **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.
  59. <div align="center">
  60. [![View Catalog](https://img.shields.io/badge/View_Catalog-Live-353535?style=for-the-badge)](https://thatrebeccarae.github.io/claude-marketing/)
  61. </div>
  62. ### Paid Media
  63. | Skill | What Claude Can Do |
  64. |-------|-------------------|
  65. | **[Google Ads](skills/google-ads/)** | Scored account audits (74 checks, A-F health grade), Quality Score optimization, Performance Max, Shopping, bidding strategies, wasted spend identification |
  66. | **[Meta Ads](skills/facebook-ads/)** | Scored account audits (46 checks, A-F health grade), creative fatigue diagnosis, pixel/CAPI health, iOS 14.5+ attribution, Advantage+ readiness |
  67. | **[Microsoft Ads](skills/microsoft-ads/)** | Scored account audits (30 checks, A-F health grade), Google import optimization, LinkedIn Profile Targeting, UET tracking, Clarity integration |
  68. | **[LinkedIn Ads](skills/linkedin-ads/)** | B2B advertising — campaign setup, professional targeting, Lead Gen Forms, ABM campaigns, Matched Audiences |
  69. | **[TikTok Ads](skills/tiktok-ads/)** | Short-form video ads — Spark Ads, TikTok Shop, creative strategy, pixel/Events API, audience targeting |
  70. | **[Cross-Platform Audit](skills/cross-platform-audit/)** | Unified multi-platform scored audit — parallel execution across Google, Meta, and Microsoft with budget-weighted aggregate health score (A-F) |
  71. | **[Account Structure Review](skills/account-structure-review/)** | Cross-platform structural audit — conversion volume thresholds, budget fragmentation, consolidation roadmaps |
  72. | **[Competitor Ads Analyst](skills/competitor-ads-analyst/)** | Competitor ad creative analysis from public ad libraries — messaging patterns, creative formats, positioning gaps |
  73. | **[Wasted Spend Finder](skills/wasted-spend-finder/)** | Systematic Google Ads and Meta waste analysis — produces uploadable exclusion lists with thematic categorization |
  74. ### SEO & AI Search
  75. | Skill | What Claude Can Do |
  76. |-------|-------------------|
  77. | **[AEO/GEO Optimizer](skills/aeo-geo-optimizer/)** | AI search optimization — appear in ChatGPT, Perplexity, Google AI Overviews. Content scoring, citation patterns, AI crawler management |
  78. | **[Technical SEO Audit](skills/technical-seo-audit/)** | Deep crawl analysis, Core Web Vitals, indexation health, site architecture, canonical tags, structured data validation |
  79. | **[Schema Markup Generator](skills/schema-markup-generator/)** | JSON-LD structured data — Article, FAQ, HowTo, Product, Review, LocalBusiness, BreadcrumbList |
  80. | **[Programmatic SEO](skills/programmatic-seo/)** | Template-based page generation at scale — integration pages, location pages, comparison pages, internal linking |
  81. | **[SEO Content Writer](skills/seo-content-writer/)** | SEO-optimized content with brand voice analysis — blog posts, social media, email campaigns, landing pages |
  82. | **[llms.txt](skills/llms-txt/)** | Generate llms.txt files for AI discoverability — helps answer engines surface your project accurately |
  83. ### Content
  84. | Skill | What Claude Can Do |
  85. |-------|-------------------|
  86. | **[Content Creator](skills/content-creator/)** | Brand voice analysis, SEO optimization scripts, content calendar planning, multi-platform strategy |
  87. | **[Copywriting Frameworks](skills/copywriting-frameworks/)** | AIDA, PAS, BAB, 4Ps, StoryBrand, QUEST, FAB — framework-driven copy for ads, pages, emails |
  88. | **[Social Media Strategy](skills/social-media-strategy/)** | Platform-specific organic strategy, content pillar framework, engagement tactics, content calendars |
  89. | **[Email Composer](skills/email-composer/)** | Client outreach, deliverable handoffs, scope discussions, and follow-up cadence — with tone calibration per context |
  90. | **[Content Pipeline](skills/content-pipeline/)** | Multi-agent orchestration — chains research, editorial review, and social distribution agents in sequence |
  91. | **[Content Workflow](skills/content-workflow/)** | End-to-end content pipeline: research → draft → editorial review → social distribution |
  92. ### Growth & Conversion
  93. | Skill | What Claude Can Do |
  94. |-------|-------------------|
  95. | **[CRO Auditor](skills/cro-auditor/)** | Conversion rate optimization — LIFT model heuristic evaluation, ICE/PIE prioritization, A/B test hypothesis generation |
  96. | **[Landing Page Optimizer](skills/landing-page-optimizer/)** | Page audit and optimization — above-the-fold, value props, CTAs, social proof, forms, mobile |
  97. | **[A/B Testing Framework](skills/ab-testing-framework/)** | Experiment design, sample size calculation, statistical significance, Bayesian vs frequentist analysis |
  98. | **[Retention & Churn Prevention](skills/retention-churn-prevention/)** | Churn analysis, customer health scoring, cohort analysis, win-back campaigns, CLV calculation |
  99. ### Strategy & Research
  100. | Skill | What Claude Can Do |
  101. |-------|-------------------|
  102. | **[Brand DNA](skills/brand-dna/)** | Extract brand identity from a URL — voice, colors, typography, imagery, values, audience — into brand-profile.json for downstream skill consumption |
  103. | **[Brand Voice & Guidelines](skills/brand-voice-guidelines/)** | Voice development, personality archetypes, tone matrices, messaging frameworks, style guides |
  104. | **[Market Research](skills/market-research/)** | Consulting-grade research reports (50+ pages) — Porter's Five Forces, PESTLE, SWOT, TAM/SAM/SOM, competitive positioning |
  105. | **[ICP Research](skills/icp-research/)** | Ideal customer profiles with pain points, objections, buying triggers, community research, and voice-of-customer extraction |
  106. | **[Customer Journey Mapping](skills/customer-journey-mapping/)** | Journey stage mapping, touchpoint inventory, drop-off analysis, persona-based journey variants |
  107. | **[Pricing Strategy](skills/pricing-strategy/)** | Pricing models, value metric selection, competitive analysis, pricing page optimization, tier design |
  108. | **[Research Digest](skills/research-digest/)** | Structured research briefs from RSS feeds and web sources — source synthesis, credibility assessment, content angles |
  109. | **[Cold Email & Outreach](skills/cold-email-outreach/)** | Outbound prospecting sequences, deliverability optimization, personalization tiers, CAN-SPAM/GDPR compliance |
  110. ### Email & Lifecycle
  111. | Skill | What Claude Can Do |
  112. |-------|-------------------|
  113. | **[Klaviyo Analyst](skills/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. |
  114. | **[Klaviyo Developer](skills/klaviyo-developer/)** | Event schema design, SDK integration, webhook handling, rate limit strategy, catalog sync. MCP-aware for exploration; SDK-first for production integrations. |
  115. | **[Braze](skills/braze/)** | Canvas audit, segmentation, cross-channel orchestration, data architecture, deliverability, IP warming |
  116. ### Analytics
  117. | Skill | What Claude Can Do |
  118. |-------|-------------------|
  119. | **[Google Analytics](skills/google-analytics/)** | GA4 traffic analysis, channel comparison, conversion funnels, content performance |
  120. | **[Google Tag Manager](skills/google-tag-manager/)** | Container audits, consent mode v2, server-side tagging, debugging, tag architecture |
  121. | **[Looker Studio](skills/looker-studio/)** | Cross-platform dashboards via Google Sheets pipeline, DTC dashboard templates, calculated field library |
  122. | **[Shopify](skills/shopify/)** | 12-step store audit, conversion funnel analysis, site speed diagnostics, marketing stack integration |
  123. | **[UTM & Attribution Strategy](skills/utm-attribution-strategy/)** | UTM taxonomy design, attribution model selection, cross-channel measurement, GA4 attribution configuration |
  124. ### Creative & Design
  125. | Skill | What Claude Can Do |
  126. |-------|-------------------|
  127. | **[Frontend Design](skills/frontend-design/)** | Distinctive, production-grade web interfaces — typography, color theory, motion, spatial composition. Commits to a specific aesthetic direction, not generic defaults. |
  128. | **[Tech Diagram](skills/tech-diagram/)** | Technical architecture diagrams as standalone HTML — pipeline flows, layer stacks, component maps, timelines |
  129. | **[Remotion Video](skills/remotion-video/)** | Programmatic video production — spring animations, chart animations, scene transitions, audio sync |
  130. ### Reporting & Deliverables
  131. | Skill | What Claude Can Do |
  132. |-------|-------------------|
  133. | **[Pro Deck Builder](skills/pro-deck-builder/)** | Polished HTML slide decks and PDF-ready reports — dark covers, warm light content, component library |
  134. | **[Pro Report Builder](skills/pro-report-builder/)** | HTML consulting reports — dark cover, warm cream pages, KPI cards, data tables, recommendation cards, PDF export |
  135. | **[HTML Report Builder](skills/html-report-builder/)** | Multi-page HTML reports for consulting deliverables — KPI cards, data tables, callout boxes, recommendation cards |
  136. | **[Data Viz Deck](skills/data-viz-deck/)** | PPTX decks, interactive HTML dashboards, and chart generation from audit data |
  137. ### DevOps
  138. | Skill | What Claude Can Do |
  139. |-------|-------------------|
  140. | **[GitHub README](skills/github-readme/)** | Project-type-aware README generation, audit (scored 0-100), and update — with voice calibration and SEO/AEO discoverability guidance |
  141. | **[Repo Health](skills/repo-health/)** | One-command repo health audit — checks standard files, GitHub config, branch protection, documentation quality |
  142. | **[Repo Scaffold](skills/repo-scaffold/)** | Initialize repos with standard files — LICENSE, CONTRIBUTING, SECURITY, issue/PR templates, CI config |
  143. | **[Sync Repos](skills/sync-repos/)** | Manage public/private repo pairs — verify parity, detect drift, run sync scripts, validate no data leaks |
  144. | **[Dep Audit](skills/dep-audit/)** | Cross-repo dependency audit — outdated packages, security advisories, version conflicts, license issues |
  145. | **[Release Notes](skills/release-notes/)** | Generate changelogs and GitHub releases from git history — conventional commits, PR grouping, semver |
  146. | **[Social Preview](skills/social-preview/)** | Generate OG social preview images (1280x640) for GitHub repos — branded templates, dark/light themes |
  147. | **[Safe Push](skills/safe-push/)** | Pre-push hygiene — PII/secrets scanning, commit message audit, rate-limited pushing, allowlist support |
  148. ## Skill Packs
  149. Grouped collections with setup wizards for installing related skills together:
  150. <!-- PACK-LIST-START -->
  151. - **[Content Pack](skill-packs/content-pack.md)** — 3 skills for SEO content, editorial pipelines, and client communication. (seo-content-writer, content-workflow, email-composer)
  152. - **[Creative & Design Pack](skill-packs/creative-pack.md)** — 3 skills for frontend interfaces, technical diagrams, and programmatic video. (frontend-design, tech-diagram, remotion-video)
  153. - **[Developer Tools Pack](skill-packs/dev-tools-pack.md)** — 2 skills for pre-push security scanning and README generation. (safe-push, github-readme)
  154. - **[DTC Skill Pack](skill-packs/dtc-pack.md)** — 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)
  155. - **[Paid Media Pack](skill-packs/paid-media-pack.md)** — 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)
  156. - **[Strategy & Research Pack](skill-packs/strategy-pack.md)** — 3 skills for market research, ICP development, and research synthesis. (market-research, icp-research, research-digest)
  157. <!-- PACK-LIST-END -->
  158. ## Multi-Tool Support
  159. 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.
  160. ### Quick Install
  161. ```bash
  162. bash scripts/install.sh
  163. ```
  164. Auto-detects your installed tools, lets you choose which to install for.
  165. ### Per-Tool Quick-Start
  166. **Cursor** — One rule file per skill, auto-suggested by Cursor agent.
  167. ```bash
  168. cp integrations/cursor/*.mdc your-project/.cursor/rules/
  169. ```
  170. **Aider** — Skills load every session via config.
  171. ```bash
  172. cp integrations/aider/CONVENTIONS.md your-project/
  173. echo "read: CONVENTIONS.md" >> your-project/.aider.conf.yml
  174. ```
  175. **Windsurf** — All skills in one file, always active.
  176. ```bash
  177. cp integrations/windsurf/.windsurfrules your-project/
  178. ```
  179. **GitHub Copilot** — Works in VS Code and on GitHub.com.
  180. ```bash
  181. cp integrations/copilot/*.instructions.md your-project/.github/instructions/
  182. ```
  183. **Gemini CLI** — Modular loading via `@import`.
  184. ```bash
  185. cp -r integrations/gemini/* your-project/
  186. ```
  187. ### Compatibility Matrix
  188. Not all skill content translates across formats — some tools have size limits or don't support file references.
  189. | Content | Claude Code | Cursor | Aider | Windsurf | Copilot | Gemini CLI |
  190. |---------|:-----------:|:------:|:-----:|:--------:|:-------:|:----------:|
  191. | Core capabilities | Full | Full | Summary | Summary | Full | Full |
  192. | Reference data | Full | Partial | — | — | — | Full (@import) |
  193. | Examples | Full | — | — | — | — | Optional |
  194. | Install command | Full | — | — | — | — | — |
  195. ### Advanced Usage
  196. To regenerate `integrations/` after editing skills:
  197. ```bash
  198. bash scripts/convert.sh
  199. ```
  200. See [CONTRIBUTING.md](CONTRIBUTING.md) for adding new skills and keeping converted output in sync.
  201. ## How Skills Work
  202. 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.
  203. #### What a Skill Contains
  204. | File | Purpose |
  205. |------|---------|
  206. | **SKILL.md** | Frontmatter + instructions Claude reads at invocation — frameworks, decision trees, diagnostic patterns |
  207. | **REFERENCE.md** | Platform-specific data: industry benchmarks, API schemas, field mappings, rate limits |
  208. | **EXAMPLES.md** | Working examples with realistic prompts and expected output format |
  209. | **scripts/** | Utility scripts for setup, data fetching, health checks (where applicable) |
  210. #### How Claude Uses Them
  211. 1. You ask a question in natural language (e.g., *"Audit my Klaviyo flows"*)
  212. 2. Claude loads the relevant skill's SKILL.md, which contains the diagnostic framework
  213. 3. Claude references REFERENCE.md for benchmarks, thresholds, and platform-specific data
  214. 4. If an MCP server is configured (e.g., Klaviyo), Claude pulls live data from your account
  215. 5. Claude delivers structured analysis with specific recommendations — not generic advice
  216. > [!NOTE]
  217. > 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.
  218. ### Agents and Workflows
  219. Agents are standalone analysis modules with portable logic — comparison engines, prompt builders, response parsers. Each agent works independently and can be used without n8n.
  220. 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.
  221. 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.
  222. ## Agents
  223. Standalone agents with portable analysis logic — usable independently or wired together by a workflow.
  224. | Agent | What It Does |
  225. |-------|-------------|
  226. | **[GA4 Monitor](agents/ga4-monitor/)** | Compares GA4 event data against a tracking spec, flags gaps, unexpected events, and volume anomalies |
  227. | **[GA4 Gap Analyzer](agents/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`. |
  228. | **[GTM Implementer](agents/gtm-implementer/)** | Creates GTM variables, triggers, and tags — rate-limited, idempotent, workspace-isolated |
  229. 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.
  230. ## Workflows
  231. Autonomous n8n pipelines that wire agents together on a schedule. They monitor, analyze, and act — then notify you with results.
  232. ### [GA4-GTM Pipeline](workflows/ga4-gtm-pipeline/) — Daily GA4 monitoring + GTM implementation
  233. GA4 tracking gaps cost you conversion data every day. This pipeline detects them automatically and patches them in GTM.
  234. | Stage | Agent | What Happens |
  235. |-------|-------|-------------|
  236. | **Monitor** | [GA4 Monitor](agents/ga4-monitor/) | Fetches all GA4 events daily, compares against your event spec |
  237. | **Analyze** | [GA4 Gap Analyzer](agents/ga4-gap-analyzer/) | Claude Opus (with adaptive thinking) identifies gaps and recommends GTM implementations; Claude Haiku diagnoses anomalies |
  238. | **Implement** | [GTM Implementer](agents/gtm-implementer/) | Creates GTM variables, triggers, and tags in an isolated workspace (unpublished until you review) |
  239. | **Notify** | — | Slack messages at every stage — all-clear, gaps found, anomalies detected, GTM resources created |
  240. Handles multiple GA4 properties — configure once per property, runs hands-off from there.
  241. See the [GA4-GTM Pipeline README](workflows/ga4-gtm-pipeline/README.md) for the architecture overview, or the [Complete Guide](https://thatrebeccarae.kit.com/claude-marketing-guide) for the full n8n build walkthrough.
  242. ## Composing Skills
  243. Skills are most powerful when chained together — each skill's output becomes context for the next. See the [full composing guide](examples/) for how context flows between skills.
  244. | Workflow | Skills Chained | What You Get |
  245. |----------|---------------|--------------|
  246. | **[DTC Account Audit](examples/dtc-account-audit.md)** | ICP Research → Klaviyo Analyst → Google Analytics → Pro Deck Builder | Client-ready audit deck in ~45 min |
  247. | **[Paid Media Optimization](examples/paid-media-optimization.md)** | Wasted Spend Finder → Competitor Ads Analyst → Google Ads → Account Structure Review | Exclusion lists + restructuring roadmap |
  248. | **[Content Production](examples/content-production.md)** | Research Digest → ICP Research → SEO Content Writer → Content Workflow | SEO article + social distribution pack |
  249. ## Example Prompts
  250. ### Email & Lifecycle
  251. ```
  252. "Audit my Klaviyo flows and identify which essential flows I'm missing"
  253. "My checkout completion rate is 31% — what's causing the drop-off?"
  254. "Which traffic sources are driving the most conversions this month?"
  255. ```
  256. ### Paid Media
  257. ```
  258. "Analyze my Google Ads search terms and find wasted spend"
  259. "Pull competitor ads from Meta Ad Library for these 3 brands and find messaging gaps"
  260. "Run a full cross-platform audit across Google, Meta, and Microsoft — give me a unified health score and deck"
  261. ```
  262. ### Content & Strategy
  263. ```
  264. "Build an ICP for our SaaS product targeting VP of Marketing at mid-market companies"
  265. "Write a 1,500-word SEO article targeting 'email marketing benchmarks for DTC brands'"
  266. "Generate a research brief on AI in email marketing from the last 30 days"
  267. ```
  268. ### Creative & Reporting
  269. ```
  270. "Create a dark-mode deck summarizing this month's email performance"
  271. "Build an HTML audit report from these Klaviyo metrics"
  272. "Design a landing page for our analytics product — editorial aesthetic, not typical SaaS"
  273. ```
  274. ### Developer Tools
  275. ```
  276. "Audit this repo's README and score it"
  277. "Run a health check across all my public repos"
  278. "Scaffold a new repo with standard files and CI config"
  279. "Generate release notes from the last 20 commits"
  280. "Check for outdated dependencies across all my Node projects"
  281. ```
  282. ## Configuration
  283. ### Setup Wizard Options
  284. | Flag | What It Does |
  285. |------|-------------|
  286. | `python scripts/setup.py` | Full interactive setup |
  287. | `--skip-install` | Skip dependency installation |
  288. | `--skills klaviyo,shopify` | Install specific skills only |
  289. | `--non-interactive` | Use environment variables, skip prompts |
  290. ### API Keys by Platform
  291. | Platform | Key Required | Where to Get It |
  292. |----------|-------------|-----------------|
  293. | **Klaviyo** | Private API Key (`pk_...`) | Klaviyo > Settings > API Keys |
  294. | **Google Analytics** | Service account JSON + Property ID | Google Cloud Console > IAM > Service Accounts |
  295. | **Shopify** | Admin API access token | Shopify Admin > Apps > Develop Apps |
  296. | **Looker Studio** | Google Sheets API credentials | Google Cloud Console > APIs & Services |
  297. > [!IMPORTANT]
  298. > 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](SECURITY.md) for full credential handling guidance.
  299. <details>
  300. <summary><strong>Klaviyo MCP server setup</strong></summary>
  301. The [official Klaviyo MCP server](https://developers.klaviyo.com/en/docs/klaviyo_mcp_server) gives Claude direct access to your Klaviyo account. The setup path depends on which Claude surface you're using.
  302. **Option A — Claude Chat or Cowork (Connector Directory, ~2 min)**
  303. Klaviyo is in Claude's Connector Directory as of the expanded Klaviyo + Anthropic integration ([announced 2026-05-07](https://www.klaviyo.com/newsroom/klaviyo-anthropic-expanded-integration)). Setup is:
  304. 1. Open Claude → **Settings → Connectors → Browse Connectors**
  305. 2. Search for **Klaviyo**
  306. 3. Click **Connect** and authenticate
  307. Available on Claude **Pro, Max, Team, and Enterprise** plans. Free plan users need to use Claude Code or the local install path below.
  308. **Option B — Claude Code (remote MCP)**
  309. ```bash
  310. claude mcp add klaviyo --transport http https://mcp.klaviyo.com/mcp
  311. ```
  312. For audit-only sessions:
  313. ```bash
  314. claude mcp add klaviyo --transport http "https://mcp.klaviyo.com/mcp?read-only=true"
  315. ```
  316. **Option C — Local MCP via uvx (CI containers, offline development)**
  317. 1. Install uv: `curl -LsSf https://astral.sh/uv/install.sh | sh`
  318. 2. Add to `~/.mcp.json`:
  319. ```json
  320. {
  321. "mcpServers": {
  322. "klaviyo": {
  323. "command": "uvx",
  324. "args": ["klaviyo-mcp-server@latest"],
  325. "env": {
  326. "PRIVATE_API_KEY": "${KLAVIYO_API_KEY}",
  327. "READ_ONLY": "true",
  328. "ALLOW_USER_GENERATED_CONTENT": "false"
  329. }
  330. }
  331. }
  332. }
  333. ```
  334. 3. Restart Claude Code and verify with `/mcp`
  335. **Klaviyo-side requirement:** Owner, Admin, or Manager role to authorize the connection (any option above).
  336. 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](skills/klaviyo-analyst/REFERENCE.md#mcp-server-reference) for the full tool inventory. See the [DTC Pack guide](skill-packs/dtc-pack.md) for recommended Klaviyo API scopes when using the local option.
  337. </details>
  338. ## Security
  339. All scripts include input validation, path sanitization, SSRF protection, and secure credential handling. Key principles:
  340. - **API keys** stored in `.env` files (gitignored), never hardcoded
  341. - **Read-only API access** by default — write scopes are opt-in
  342. - **No PII extraction** — skills work with aggregates, not individual customer data
  343. - **No persistent storage** — analysis runs in-memory, output goes to local files you control
  344. For vulnerability reporting and full security design details, see [SECURITY.md](SECURITY.md).
  345. ## Troubleshooting
  346. <details>
  347. <summary><strong>Skills not loading in Claude Code</strong></summary>
  348. 1. Verify skills are in the right directory: `ls ~/.claude/skills/`
  349. 2. Each skill folder should contain at least a `SKILL.md` file
  350. 3. Restart Claude Code after copying skills
  351. 4. Check that SKILL.md frontmatter is valid YAML
  352. </details>
  353. <details>
  354. <summary><strong>API key errors</strong></summary>
  355. 1. Confirm your `.env` file is in the project root (not inside a skill folder)
  356. 2. Klaviyo keys must start with `pk_` — if yours doesn't, you may have copied a public key
  357. 3. Google service account JSON path must be absolute, not relative
  358. 4. Run `python scripts/setup.py` to re-validate all keys
  359. </details>
  360. <details>
  361. <summary><strong>Python version issues</strong></summary>
  362. The setup wizard requires Python 3.8+. Check your version:
  363. ```bash
  364. python --version
  365. # or
  366. python3 --version
  367. ```
  368. On macOS, `python` may point to Python 2. Use `python3` explicitly or install via Homebrew: `brew install python`
  369. </details>
  370. <details>
  371. <summary><strong>MCP server not connecting</strong></summary>
  372. 1. Verify `~/.mcp.json` syntax is valid JSON (no trailing commas)
  373. 2. Confirm `uv` is installed: `uv --version`
  374. 3. Check that your `KLAVIYO_API_KEY` environment variable is set: `echo $KLAVIYO_API_KEY`
  375. 4. Restart Claude Code — MCP servers load at startup
  376. </details>
  377. ## Documentation
  378. ### Skill Packs
  379. <!-- PACK-DOCS-START -->
  380. | Pack | Skills | Description |
  381. |------|--------|-------------|
  382. | [Content Pack](skill-packs/content-pack.md) | 3 | 3 skills for SEO content, editorial pipelines, and client communication. |
  383. | [Creative & Design Pack](skill-packs/creative-pack.md) | 3 | 3 skills for frontend interfaces, technical diagrams, and programmatic video. |
  384. | [Developer Tools Pack](skill-packs/dev-tools-pack.md) | 2 | 2 skills for pre-push security scanning and README generation. |
  385. | [DTC Skill Pack](skill-packs/dtc-pack.md) | 6 | 6 skills that give Claude Code deep expertise in DTC e-commerce marketing. |
  386. | [Paid Media Pack](skill-packs/paid-media-pack.md) | 6 | 6 skills for cross-platform paid media — Google Ads, Meta Ads, Microsoft Ads, competitive analysis, waste detection, and account structure review. |
  387. | [Strategy & Research Pack](skill-packs/strategy-pack.md) | 3 | 3 skills for market research, ICP development, and research synthesis. |
  388. <!-- PACK-DOCS-END -->
  389. ### Other Resources
  390. | Resource | Description |
  391. |----------|-------------|
  392. | [The Marketing Expertise Layer for Claude Code](https://dgtldept.substack.com/p/the-marketing-expertise-layer-for-claude-code) | Companion essay on dgtl dept* — three skills walked end-to-end with the prompts I actually type |
  393. | [Claude Marketing — The Complete Guide](https://thatrebeccarae.kit.com/claude-marketing-guide) | Free Notion reference. Six pages: install, credentials, six skills to start with, scored audits explained, five workflow chains, the n8n pipeline build, troubleshooting |
  394. | [Composing Skills](examples/) | How to chain skills together — context flow, tips, and 3 worked workflow examples |
  395. | [DTC Getting Started](skill-packs/dtc-getting-started.md) | Step-by-step setup for DTC platforms |
  396. | [Paid Media Getting Started](skill-packs/paid-media-getting-started.md) | Step-by-step setup for paid media platforms |
  397. | [GA4-GTM Pipeline README](workflows/ga4-gtm-pipeline/README.md) | Pipeline architecture, agent orchestration, setup, and security model |
  398. | [CHANGELOG](CHANGELOG.md) | Version history and release notes |
  399. | [SECURITY](SECURITY.md) | Security design and vulnerability reporting |
  400. | [CONTRIBUTING](CONTRIBUTING.md) | How to contribute skills, report bugs, submit PRs |
  401. ## Contributing
  402. Contributions are welcome — bug reports, documentation fixes, skill suggestions, and new skills. See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines on submitting skills, the required file structure, and the PR process.
  403. ## License
  404. MIT — see [LICENSE](LICENSE) for details.
  405. <div align="center">
  406. ---
  407. **The expertise layer your AI agent is missing.**<br>git clone it. Install what you need. Ask in plain English.
  408. <br>
  409. <br>
  410. _Please don't be a jerk and steal my work._
  411. </div>

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.