Sequenzy Email Marketing
davepoon/buildwithclaude
Agent guide for operating Sequenzy. An agent skill from davepoon/buildwithclaude.
Klaviyo marketing operations and analyst expertise. An agent skill from thatrebeccarae/claude-marketing.
Install Klaviyo Analyst
$ npx skills add thatrebeccarae/claude-marketing --skill klaviyo-analyst -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install thatrebeccarae/claude-marketing klaviyo-analyst --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/thatrebeccarae/claude-marketing.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/klaviyo-analyst .claude/skills/klaviyo-analyst && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "klaviyo-analyst" agent skill from https://github.com/thatrebeccarae/claude-marketing/tree/main/skills/klaviyo-analyst into .claude/skills/klaviyo-analyst/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "klaviyo-analyst", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/thatrebeccarae/claude-marketing/tree/main/skills/klaviyo-analystType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add thatrebeccarae/claude-marketing --skill klaviyo-analyst -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install thatrebeccarae/claude-marketing klaviyo-analyst --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/thatrebeccarae/claude-marketing.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/klaviyo-analyst .agents/skills/klaviyo-analyst && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "klaviyo-analyst" agent skill from https://github.com/thatrebeccarae/claude-marketing/tree/main/skills/klaviyo-analyst into .agents/skills/klaviyo-analyst/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "klaviyo-analyst", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add thatrebeccarae/claude-marketing --skill klaviyo-analyst -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install thatrebeccarae/claude-marketing klaviyo-analyst --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/thatrebeccarae/claude-marketing.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/klaviyo-analyst .cursor/skills/klaviyo-analyst && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "klaviyo-analyst" agent skill from https://github.com/thatrebeccarae/claude-marketing/tree/main/skills/klaviyo-analyst into .cursor/skills/klaviyo-analyst/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "klaviyo-analyst", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/thatrebeccarae/claude-marketing.git --path skills/klaviyo-analyst--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add thatrebeccarae/claude-marketing --skill klaviyo-analyst -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install thatrebeccarae/claude-marketing klaviyo-analyst --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/thatrebeccarae/claude-marketing.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/klaviyo-analyst .gemini/skills/klaviyo-analyst && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "klaviyo-analyst" agent skill from https://github.com/thatrebeccarae/claude-marketing/tree/main/skills/klaviyo-analyst into .gemini/skills/klaviyo-analyst/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "klaviyo-analyst", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install thatrebeccarae/claude-marketing klaviyo-analystInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add thatrebeccarae/claude-marketing --skill klaviyo-analyst -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/thatrebeccarae/claude-marketing.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/klaviyo-analyst .github/skills/klaviyo-analyst && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "klaviyo-analyst" agent skill from https://github.com/thatrebeccarae/claude-marketing/tree/main/skills/klaviyo-analyst into .github/skills/klaviyo-analyst/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "klaviyo-analyst", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add thatrebeccarae/claude-marketing --skill klaviyo-analyst -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install thatrebeccarae/claude-marketing klaviyo-analyst --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/thatrebeccarae/claude-marketing.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/klaviyo-analyst .opencode/skills/klaviyo-analyst && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "klaviyo-analyst" agent skill from https://github.com/thatrebeccarae/claude-marketing/tree/main/skills/klaviyo-analyst into .opencode/skills/klaviyo-analyst/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "klaviyo-analyst", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
klaviyo-analyst- GitHub stars
- 161
- Token cost
- ~5k tokens
- SKILL.md length
- 2,229 words
- Files
- 8 (incl. scripts)
- Skills in repo
- 55
- Repo updated
- First seen
- Licence
- MIT
At a glance
Klaviyo marketing operations and analyst expertise. An agent skill from thatrebeccarae/claude-marketing.
- Works in 7 steps: Install the skill → Connect the Klaviyo MCP (recommended) → Fallback: local CLI scripts (optional) → …
- The user asks about Klaviyo marketing strategy
- SKILL.md covers Install, Core Capabilities, Key Benchmarks and Essential Flows Checklist, plus 5 more sections
- Runs Python scripts from its folder; calls python, claude and git; reaches mcp.klaviyo.com; needs KLAVIYO_API_KEY and PRIVATE_API_KEY
What it does
Klaviyo Analyst is an agent skill from thatrebeccarae/claude-marketing. Klaviyo marketing operations and analyst expertise. Audit flows, segments, campaigns, deliverability, and revenue attribution. Use when the user asks about Klaviyo marketing strategy, email/SMS automation, customer segmentation, flow optimization, or lifecycle marketing. For API integration, SDK, webhook, or developer questions, see the klaviyo-developer skill.
Its SKILL.md is about 5k tokens, which your agent loads only when the skill is triggered. The skill folder holds 8 other files, including scripts (for example `EXAMPLES.md`, `REFERENCE.md` and `scripts/analyze.py`).
It sits in Marketing & SEO, covering Email marketing and Transactional email. It works with Model Context Protocol. The repository describes itself as: 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. The licence is MIT.
When your agent uses it
- The user asks about Klaviyo marketing strategy
- Email/SMS automation
- Customer segmentation
- Flow optimization
Example prompts
- “/klaviyo-analyst”
Requirements
- Python 3
- A credential in PRIVATE_API_KEY
- A credential in KLAVIYO_API_KEY
Workflow steps
7 steps, taken from the step headings in SKILL.md.
What it can do on your machine
Read from SKILL.md and the folder at commit a8a63ec. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
Ships 2 files in scripts/ (Python), which the agent can run.
Shell commands in SKILL.md call:
pythonclaudegitpip
From the folder's file list and the shell code blocks in SKILL.md.
Network
Hosts in commands or code, which the agent is likely to contact:
mcp.klaviyo.com
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names these keys or tokens, usually read from environment variables:
KLAVIYO_API_KEYPRIVATE_API_KEY
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
Klaviyo Analyst loads about 5k tokens when it runs. Until then it costs about 95 tokens; SKILL.md has 2,229 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
Safety
Auto-check: notes
The automated check noted patterns worth knowing about, such as sudo or a known installer.
- NoteMentions a .env fileSKILL.md:346
set as an environment variable or in a `.env` file - NoteMentions a .env fileSKILL.md:378
Store keys in environment variables or `.env` files - NoteMentions a .env fileSKILL.md:379
- Add `.env` to `.gitignore`
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.
SKILL.md
The full file from thatrebeccarae/claude-marketing at commit a8a63ec, republished under its MIT licence (© thatrebeccarae). 2,229 words, ~5,021 tokens.
Download SKILL.mdSave it as
.claude/skills/klaviyo-analyst/SKILL.md (or your agent's skills folder). This skill also uses 7 other files; get the full folder from GitHub.- name
- klaviyo-analyst
- description
- Klaviyo marketing operations and analyst expertise. Audit flows, segments, campaigns, deliverability, and revenue attribution. Use when the user asks about Klaviyo marketing strategy, email/SMS automation, customer segmentation, flow optimization, or lifecycle marketing. For API integration, SDK, webhook, or developer questions, see the klaviyo-developer skill.
- license
- MIT
- origin
- custom
- author
- Rebecca Rae Barton
- author_url
- https://github.com/thatrebeccarae
- metadata.version
- 1.1.0
- metadata.category
- email-lifecycle
- metadata.domain
- klaviyo
- metadata.updated
- 2026-05-14
- metadata.tested
- 2026-05-14
- metadata.tested_with
- Claude Code v2.1, Klaviyo MCP API revision 2026-04-15
Klaviyo Marketing Analyst
Expert-level guidance for Klaviyo email and SMS marketing from the marketing operations and analyst perspective — auditing, building, and optimizing flows, segments, campaigns, and integrations.
For API integration, SDK usage, event tracking implementation, webhooks, and developer patterns, see the klaviyo-developer skill.
Install
Step 1 — Install the skill
git clone https://github.com/thatrebeccarae/claude-marketing.git && cp -r claude-marketing/skills/klaviyo-analyst ~/.claude/skills/Step 2 — Connect the Klaviyo MCP (recommended)
This skill is designed around Klaviyo's official MCP server. Connect Claude to your Klaviyo account through OAuth — no local API key, no Python install. The setup path depends on which Claude surface you're using.
For Claude Chat or Claude Cowork — use the Connector Directory
Klaviyo is listed in Claude's Connector Directory (announced as part of the expanded Klaviyo + Anthropic integration on 2026-05-07). Setup takes about two minutes:
- Open Claude → Settings → Connectors → Browse Connectors
- Search for Klaviyo
- Click Connect and authenticate
Plan requirement: Connectors are available on Claude Pro, Max, Team, and Enterprise plans. Free plan users will need to use Claude Code or the local install path below.
For Claude Code — register the remote MCP
claude mcp add klaviyo --transport http https://mcp.klaviyo.com/mcpFor audit-only sessions, append ?read-only=true to disable all write tools at the protocol layer:
claude mcp add klaviyo --transport http "https://mcp.klaviyo.com/mcp?read-only=true"For local install (CI containers, offline development)
claude mcp add klaviyo -e PRIVATE_API_KEY=pk_... -e READ_ONLY=true -- uvx klaviyo-mcp-server@latestKlaviyo-side requirement: Owner, Admin, or Manager role to authorize the connection.
The MCP exposes 40+ tools across Accounts, Campaigns, Catalogs, Events, Flows, Groups, Profiles, Reporting, Templates, and Translations. See REFERENCE.md for the full tool inventory.
Step 3 — Fallback: local CLI scripts (optional)
If you need scripted CLI access for CI, cron, or headless reporting — install the Python requirements and provide a KLAVIYO_API_KEY. See the Scripts (Fallback) section below.
Core Capabilities
Flow Auditing & Optimization
- Audit existing flows against best practices (welcome series, abandoned cart, post-purchase, winback, browse abandonment, sunset)
- Identify revenue leakage from missing or underperforming flows
- Recommend split tests, timing adjustments, and conditional logic improvements
- Review flow filters and trigger conditions for accuracy
Segmentation Strategy
- Build RFM-based segments (Recency, Frequency, Monetary)
- Design engagement tiers: Active (0-30d), Warm (31-90d), At-Risk (91-180d), Lapsed (180d+)
- Create predictive segments using Klaviyo's predictive analytics (CLV, churn risk, next order date)
- Suppress unengaged contacts to protect deliverability
Campaign Strategy
- Plan campaign calendars balancing promotional and value content
- A/B testing frameworks for subject lines, send times, content blocks
- Dynamic content personalization using profile properties and catalog data
- SMS campaign compliance (TCPA, quiet hours, opt-in requirements)
Deliverability Management
- Monitor and diagnose deliverability issues (bounce rates, spam complaints, inbox placement)
- Warm-up strategies for new sending domains/IPs
- Authentication setup: SPF, DKIM, DMARC
- List hygiene practices and sunset flow design
Revenue Attribution & Reporting
- Interpret Klaviyo's attribution model (click-based, 5-day email / 24-hour SMS default windows)
- Build custom dashboards for flow revenue, campaign ROI, list growth
- Benchmark KPIs against industry standards
Event Schema Auditing
- Inventory all tracked metrics by source (built-in integration, custom API, Klaviyo-internal, forms)
- Identify duplicate/redundant events, unused events, and missing standard events
- Assess event property structures for segmentation and personalization accessibility
- Diagnose nested object limitations blocking flow splits and segment conditions
Integration Health Review
- Audit active integrations (e-commerce, review platforms, loyalty, ads)
- Identify stale/dead integrations and orphaned event sources
- Assess flow trigger architecture: direct metric triggers (robust) vs segment-entry triggers via API-synced properties (brittle)
- Evaluate catalog sync health: product coverage, variant handling, freshness
Profile Data Utilization Analysis
- Map profile properties: what's collected vs what's used in segmentation/personalization
- Identify stale calculated properties (set once, never updated)
- Flag properties on events but not synced to profiles (limits segmentation)
- Recommend property flattening strategies for nested data accessibility
Key Benchmarks
| Metric | Good | Great | Warning |
|---|---|---|---|
| Open Rate (email) | 20-25% | 30%+ | <15% |
| Click Rate (email) | 2-3% | 4%+ | <1.5% |
| Unsubscribe Rate | <0.3% | <0.1% | >0.5% |
| Spam Complaint Rate | <0.05% | <0.02% | >0.1% |
| Flow Revenue % of Total | 30-40% | 50%+ | <20% |
| SMS Click Rate | 8-12% | 15%+ | <5% |
| List Growth Rate (monthly) | 3-5% | 8%+ | <1% |
Essential Flows Checklist
- Welcome Series (3-5 emails + optional SMS) — triggers on list subscribe
- Abandoned Cart (2-3 emails + 1 SMS) — triggers on Started Checkout
- Browse Abandonment (1-2 emails) — triggers on Viewed Product, exclude recent purchasers
- Post-Purchase (2-4 emails) — triggers on Placed Order, split by first-time vs repeat
- Winback (2-3 emails) — triggers on time since last purchase (60-90 days)
- Sunset/Re-engagement (2 emails) — targets unengaged 90-180 days, then suppress
- Review Request — triggers post-delivery, integrates with review platform
- Replenishment (if applicable) — triggers based on expected repurchase cycle
- Birthday/Anniversary — triggers on date property
- VIP/Loyalty — triggers on high-CLV segment entry
Workflow: Full Klaviyo Audit (4-Phase Deep Framework)
Cowork-ready: the 4-phase audit is built for unattended execution. With the Klaviyo connector active in Cowork (read-only mode), describe the outcome — "Audit my Klaviyo flows and tell me what's missing," "Pull last week's campaign and flow performance and write me a Monday digest," "Flag every flow with open rates under 20% and write a prioritized fix-it list" — then step away. Cowork pulls the data, runs the analysis, writes the doc, and saves it to the right folder while you're in other meetings.
When asked to audit a Klaviyo account, follow this 4-phase framework:
Phase 1: Status Inventory
- List/Segment/Flow/Campaign Inventory — Count and categorize all objects by status (live, draft, inactive)
- Event Schema Inventory — Pull all metrics, categorize by source (built-in, custom API, Klaviyo-internal, forms), flag zero-volume events
- Integration Inventory — List all active integrations, identify stale connections
- Custom Profile Property Inventory — Document all custom properties with types and usage
Phase 2: Configuration Audit
- Per-Flow Configuration Teardown — For each active flow:
- Trigger type and conditions
- Smart Send settings (on/off and implications)
- Exclusion filters (segment membership, event conditions)
- Timing between messages (compare to benchmarks)
- Branching logic (conditional splits, A/B splits)
- Flow duration (first message to last)
- Campaign Targeting Audit — Segment exclusivity, frequency capping, send-time optimization
- A/B Testing Methodology Audit — Univariate vs multivariate, KPI alignment, statistical significance practices
- Deliverability Configuration — Authentication (SPF/DKIM/DMARC), dedicated IP, warmup status
Phase 3: Data Structure Audit
- Event Schema Health — Check for duplicates, missing standard events, nested objects blocking segmentation
- Profile Data Utilization — What's collected vs what's used in segmentation/personalization
- Catalog Sync Health — Product feed freshness, coverage, variant handling
Phase 4: Strategic Recommendations
- Three-Tier Recommendations — For each finding:
- Finding: What's wrong + evidence from audit data
- Recommendation: What to do (client-facing, plain language)
- Implementation Spec: How to build it (internal SOW with triggers, filters, content brief, timing, testing plan)
- Sequential Testing Plans — Univariate A/B tests with stat sig framework
- Quantified ROI — Expected uplift % x current revenue baseline
- Implementation Roadmap — Phased timeline with dependencies mapped
Industry-Specific Benchmarks
B2B / Wholesale E-Commerce
| Metric | Good | Great | Warning | Notes |
|---|---|---|---|---|
| Open Rate | 25-35% | 40%+ | <20% | Higher than DTC due to professional relevance |
| Click Rate | 3-5% | 6%+ | <2% | Product-focused CTAs perform well |
| CTOR | 10-15% | 18%+ | <8% | Key diagnostic — content relevance signal |
| Flow Revenue % | 25-35% | 40%+ | <15% | Reorder flows are high-value in B2B |
| Avg Order Value | Varies | — | — | Track by segment (industry, company size) |
| Reorder Rate | 60-70% | 80%+ | <50% | Critical for consumable categories |
DTC (Direct-to-Consumer)
| Metric | Good | Great | Warning |
|---|---|---|---|
| Open Rate | 20-25% | 30%+ | <15% |
| Click Rate | 2-3% | 4%+ | <1.5% |
| Flow Revenue % | 30-40% | 50%+ | <20% |
| Welcome Series Conv. | 3-5% | 8%+ | <2% |
| Cart Recovery Rate | 5-10% | 15%+ | <3% |
Subscription / Recurring Revenue
| Metric | Good | Great | Warning |
|---|---|---|---|
| Churn Rate (monthly) | <5% | <3% | >8% |
| Reactivation Rate | 5-10% | 15%+ | <3% |
| Replenishment Flow Conv. | 8-12% | 15%+ | <5% |
| Subscription Upgrade Rate | 3-5% | 8%+ | <1% |
SMS Platform Comparison Framework
When evaluating Klaviyo SMS vs Attentive (common in audits):
| Capability | Klaviyo SMS | Attentive |
|---|---|---|
| Email + SMS unified | Yes (native) | No (separate platform) |
| Shared segments | Yes | Requires sync |
| Unified attribution | Yes | Separate reporting |
| Conversational SMS | Limited | Strong (two-way) |
| Sign-up units | Basic (popup, form) | Advanced (two-tap, link-based) |
| AI features | Predictive analytics, smart send time | AI journeys, smart sending |
| Compliance | Built-in TCPA, quiet hours | Built-in + compliance team |
| Cost | Included in Klaviyo plan (per SMS) | Separate platform fee + per SMS |
| Best for | Unified email+SMS, simplicity | SMS-first strategy, high volume SMS |
Recommendation framework: Use Klaviyo SMS when email is the primary channel and SMS is supplementary (most B2B and mid-market DTC). Consider Attentive when SMS is a primary revenue channel (high-frequency DTC, mobile-first brands).
Show full SKILL.md (908 more words)Show less
Repeatable Audit Workflow (Klaviyo MCP Tool Sequence)
When auditing an account via the official Klaviyo MCP server (https://mcp.klaviyo.com/mcp), invoke tools in this order. All tools below are read-only and safe to run against production with the ?read-only=true URL parameter set.
| Step | MCP Tool | Purpose |
|---|---|---|
| 1 | get_account_details | Account config, timezone, integrations |
| 2 | get_metrics | Full event inventory (all metric names and IDs) |
| 3 | get_metric (per metric) | Property structure for key events (Placed Order, Started Checkout, Viewed Product) |
| 4 | get_flows | All flows with status |
| 5 | get_flow (per live flow) | Trigger details, actions, filters |
| 6 | get_flow_report (per flow) | Revenue, conversion, engagement per flow |
| 7 | get_campaigns | Recent campaigns with send dates |
| 8 | get_campaign_report (per campaign) | Open/click/unsub/revenue metrics |
| 9 | get_segments + get_segment | Segment inventory and condition definitions |
| 10 | get_lists + get_list | List inventory |
| 11 | get_catalog_items | Catalog sync health check |
| 12 | query_metric_aggregates | Time-series rollups (mirrors in-app Metric Reporting) for deliverability and revenue trend analysis |
| 13 | get_events (filtered) | Sample recent event payloads to inspect property structure and nested object usage |
After the data pull, analyze using the 4-Phase Deep Framework above.
Note on write tools: the MCP also exposes write tools (create_campaign, create_profile, update_profile, create_email_template, subscribe_profile_to_marketing, assign_template_to_campaign_message, upload_image_from_file, upload_image_from_url, create_event, plus translations). For pure audit work, gate these by connecting with ?read-only=true. Only enable writes if you're acting on a confirmed recommendation (e.g., assigning a template to a campaign you're building together with the user).
Integration Context
E-commerce Platforms
- Shopify: Native integration, syncs orders/products/customers automatically. Use Shopify-specific metrics (Placed Order, Started Checkout, Viewed Product).
- WooCommerce / BigCommerce / Magento: Similar event sync, may need plugin configuration.
- Custom platforms: Coordinate with developers using the klaviyo-developer skill for API event tracking and profile management.
Common Integration Points
- Review platforms (Yotpo, Judge.me, Stamped) for post-purchase review flows
- Loyalty programs (Smile.io, LoyaltyLion) for points-based segmentation
- Subscription platforms (Recharge, Bold) for subscription lifecycle flows
- SMS: Built-in Klaviyo SMS or integration with Attentive/Postscript
How to Use This Skill
Ask me questions like:
- "Audit my Klaviyo flows and identify gaps"
- "Design a welcome series for my DTC brand"
- "My open rates dropped — help me diagnose deliverability issues"
- "Build an RFM segmentation strategy"
- "What A/B tests should I run on my abandoned cart flow?"
- "Help me set up a sunset flow to clean my list"
- "Plan a Black Friday email/SMS campaign calendar"
- "Audit my event schema — are we tracking everything we need?"
- "Give me a three-tier recommendation for fixing our click rates"
Analysis Examples
For complete analysis patterns, worked examples with sample output, and use cases, see EXAMPLES.md.
Scripts (Fallback: Local CLI)
When to use these: scripted CLI access for CI/cron, headless reporting jobs, or environments where you can't connect the Klaviyo MCP (e.g., automated pipelines using
KLAVIYO_API_KEYenv vars). For interactive analysis in Claude Code/Chat/Cowork, prefer the MCP path above — it's faster, OAuth-authenticated, and exposes the same data.
The skill includes utility scripts for data fetching and analysis:
Fetch Klaviyo Data
# List all flows
python scripts/klaviyo_client.py --resource flows
# List campaigns as table
python scripts/klaviyo_client.py --resource campaigns --format table
# Get flow performance report
python scripts/klaviyo_client.py --resource report --report-type flow --id FLOW_ID
# Export metrics to file
python scripts/klaviyo_client.py --resource metrics --output metrics.jsonAnalyze and Generate Reports
# Full account audit
python scripts/analyze.py --analysis-type full-audit
# Flow gap analysis
python scripts/analyze.py --analysis-type flow-audit
# Segment health check
python scripts/analyze.py --analysis-type segment-health
# Campaign performance comparison
python scripts/analyze.py --analysis-type campaign-comparison --days 30
# Deliverability diagnostic
python scripts/analyze.py --analysis-type deliverability
# Revenue attribution
python scripts/analyze.py --analysis-type revenue-attributionThe scripts handle API authentication, data fetching, and analysis. I'll interpret the results and provide actionable recommendations.
Troubleshooting
MCP connection issues
MCP not appearing in Claude: Verify the MCP is configured in your client and authenticated. For Claude Code, check ~/.claude.json or your project-level MCP config. For Claude Chat, check Settings → Connectors.
OAuth permission denied: Your Klaviyo user role must be Owner, Admin, or Manager. Lower-permission users cannot authorize the MCP.
Write tools failing: Confirm the connection URL does not have ?read-only=true set. If it does, write tools will be disabled by design — switch to a read-write URL for write actions.
Multi-account confusion: The MCP supports multi-account setups. If Claude pulls data from the wrong account, re-authenticate or check your active account in Klaviyo's UI.
Script (fallback) errors
Authentication Error: Verify that:
KLAVIYO_API_KEYis set as an environment variable or in a.envfile- The key starts with
pk_(private API key, not public) - The key has read scopes:
profiles:read,flows:read,campaigns:read,segments:read,lists:read,metrics:read
No Data Returned: Check that:
- The API key is associated with the correct Klaviyo account
- The account has active flows, campaigns, or segments to analyze
- Filters are correctly formatted (e.g.,
equals(status,"live"))
Rate Limit Errors: The SDK handles retries automatically (up to 3 retries with 60s max delay). If you still hit limits:
- Reduce concurrent requests
- Add delays between sequential calls
- Check
RateLimit-Remainingheader
Import Errors: Install required packages:
pip install klaviyo-api python-dotenv pandasSecurity Notes
When using the Klaviyo MCP (recommended)
- The MCP uses OAuth — there's no API key to commit, rotate, or leak
- For audit-only work, gate with
?read-only=trueon the connection URL to disable all write tools - Authorization is scoped to your Klaviyo user role (Owner / Admin / Manager) — least-privilege is enforced upstream
- Re-authentication is required if your role changes or the OAuth token expires
- Multi-account setups: confirm the active account before running tools that include write operations
When using the script fallback
- Never hardcode API keys in code or commit them to version control
- Store keys in environment variables or
.envfiles - Add
.envto.gitignore - Use read-only scopes for analyst tasks — no write access needed
- Rotate API keys periodically in Klaviyo Settings
Data Privacy
This skill accesses aggregated marketing data only. It does not:
- Access personally identifiable information (PII) beyond email/profile aggregates
- Store Klaviyo data persistently
- Share data with external services
- Modify your Klaviyo configuration (read-only operations)
All data is processed locally and used only to generate recommendations during the conversation.
For detailed Klaviyo data model, flow builder reference, segmentation conditions, deliverability, and SMS reference, see REFERENCE.md.
For API integration, SDK usage, and developer patterns, use the klaviyo-developer skill.
© thatrebeccarae, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
SKILL.md and 7 other files (scripts) in skills/klaviyo-analyst of thatrebeccarae/claude-marketing.
- SKILL.md
- .env.example
- EXAMPLES.md
- LICENSE
- REFERENCE.md
- requirements.txt
- scripts/analyze.py
- scripts/klaviyo_client.py
Open the folder on GitHubat commit a8a63ec
Compare with similar skills
Klaviyo Analyst next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Klaviyo Analyst this skillthatrebeccarae/claude-marketing | 161 | — | ~5k | Automated safety check: Notes | MIT | |
| Sequenzy Email Marketingdavepoon/buildwithclaude | 3.6k | — | ~1.7k | Automated safety check: Pass | MIT | |
| EmailAgriciDaniel/claude-email | 130 | — | ~2k | Automated safety check: Notes | MIT | |
| Email Marketing Biblesickn33/agentic-awesome-skills | 47k | — | ~8.7k | Automated safety check: Pass | MIT | |
| Email Quality Auditoraaron-he-zhu/aaron-marketing-skills | 2.9k | 2 repos | ~2.1k | Automated safety check: Pass | Apache-2.0 | |
| Mailcoachfreekmurze/dotfiles | 1k | — | ~1.3k | Automated safety check: Pass | None |
Similar skills
Email
AgriciDaniel/claude-email
Comprehensive email management and marketing for any business type.
Email Marketing Bible
sickn33/agentic-awesome-skills
Data-backed email marketing for AI agents: automation flows, deliverability triage, copy de-slopping, AI email design, ESP control via MCP with send gates and compliance.
Email Quality Auditor
aaron-he-zhu/aaron-marketing-skills
A skill your agent uses when the user asks to "audit an email program" or "is this campaign safe to send"; runs a typed 20-item SEND profile with authentication, consent, opt-out, and claim veto…
Mailcoach
freekmurze/dotfiles
Manage email marketing with the Mailcoach CLI — email lists, subscribers, campaigns, transactional emails, templates, automations, tags, and segments.
Smartlead Spintax
growthenginenowoslawski/coldoutboundskills
Adds Smartlead-compatible spintax to cold email sequences for deliverability.
More from thatrebeccarae/claude-marketing
All 55 skills in this repoGoogle Analytics
thatrebeccarae/claude-marketing
Analyze Google Analytics data, review website performance metrics, identify traffic patterns, and suggest data-driven improvements.
Content Creator
thatrebeccarae/claude-marketing
Comprehensive content marketing toolkit with brand voice analysis, SEO optimization scripts, content frameworks, social media strategy, and content calendar planning.
Klaviyo Developer
thatrebeccarae/claude-marketing
Klaviyo API and developer integration expertise. An agent skill from thatrebeccarae/claude-marketing.
Looker Studio
thatrebeccarae/claude-marketing
Looker Studio (formerly Google Data Studio) expertise. An agent skill from thatrebeccarae/claude-marketing.
Shopify
thatrebeccarae/claude-marketing
Shopify e-commerce platform marketing expertise. An agent skill from thatrebeccarae/claude-marketing.
Ab Testing Framework
thatrebeccarae/claude-marketing
A/B and multivariate testing methodology. An agent skill from thatrebeccarae/claude-marketing.
Related
Works with
Categories
Questions about Klaviyo Analyst
What does Klaviyo Analyst do?
Klaviyo marketing operations and analyst expertise. An agent skill from thatrebeccarae/claude-marketing. Klaviyo Analyst is an agent skill from thatrebeccarae/claude-marketing. Klaviyo marketing operations and analyst expertise.
When should I use Klaviyo Analyst?
Klaviyo Analyst fits situations like: the user asks about Klaviyo marketing strategy; email/SMS automation; customer segmentation; flow optimization.
How do I install Klaviyo Analyst in Claude Code?
Run `npx skills add thatrebeccarae/claude-marketing --skill klaviyo-analyst -a claude-code`. Or copy the skill folder (skills/klaviyo-analyst in thatrebeccarae/claude-marketing) into .claude/skills/klaviyo-analyst in your project. Claude Code loads it when a task matches its description.
How do I install Klaviyo Analyst in Codex?
Run `npx skills add thatrebeccarae/claude-marketing --skill klaviyo-analyst -a codex`. Or copy the skill folder (skills/klaviyo-analyst in thatrebeccarae/claude-marketing) into .agents/skills/klaviyo-analyst in your project. Codex loads it when a task matches its description.
Can I use Klaviyo Analyst in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add thatrebeccarae/claude-marketing --skill klaviyo-analyst -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/klaviyo-analyst, .gemini/skills/klaviyo-analyst, .github/skills/klaviyo-analyst and .opencode/skills/klaviyo-analyst in your project.
What does Klaviyo Analyst need to run?
Going by SKILL.md and its folder, Klaviyo Analyst needs Python for the scripts in its folder, the command-line tools its instructions call (python, claude, git and pip) and credentials named KLAVIYO_API_KEY and PRIVATE_API_KEY. Our summary lists: Python 3; A credential in PRIVATE_API_KEY; A credential in KLAVIYO_API_KEY.
Does Klaviyo Analyst access the network?
SKILL.md names 1 domain. In commands or code: mcp.klaviyo.com; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.
Is Klaviyo Analyst safe to install?
Our automated static check of SKILL.md found notes only (mentions a .env file), nothing it rates as a warning. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.
What licence does Klaviyo Analyst use?
Klaviyo Analyst is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does Klaviyo Analyst use?
About 5k tokens (SKILL.md is roughly 20k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
What are the alternatives to Klaviyo Analyst?
Skills that share tags, products or a category with Klaviyo Analyst: Sequenzy Email Marketing (davepoon/buildwithclaude, 3.6k stars), Email (AgriciDaniel/claude-email, 130 stars), Email Marketing Bible (sickn33/agentic-awesome-skills, 47k stars) and Email Quality Auditor (aaron-he-zhu/aaron-marketing-skills, 2.9k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Klaviyo Analyst?
thatrebeccarae (a GitHub user) maintains it in thatrebeccarae/claude-marketing, which has 161 GitHub stars. The repository holds 55 skills in this directory. The repository was last updated on May 14, 2026.
Source: thatrebeccarae/claude-marketing on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.