Sandbox
@CosmoBlk/email-marketing-bible

Email marketing skill for Claude Code and agents

This skill teaches an agent how to audit an email setup, build common flows, draft copy, direct email design, and diagnose deliverability problems. It also adds send-safety gates, compliance checks, and industry playbooks so the agent works from proven patterns instead of generic model output.

291 stars37 forksUpdated 9d ago
Who it's for

Builders who want an agent to help with email campaigns, flows, and deliverability.

What it delivers

You can have your agent plan, draft, audit, and stage email work with fewer wrong assumptions and safer sends.

What it does

Flow building

Builds welcome, cart, post-purchase, and win-back flows from a prompt, then reviews timing, exits, and copy before launch.

Account audits

Checks flows, segments, deliverability, and compliance, then points out what is missing.

Copy de-slopping

Writes using PAS, AIDA, and BAB, then strips the obvious AI tells before send.

Email design direction

Uses Discover, Define, Deliver, screenshot critique, and inbox-safe output formats like MJML or React Email.

ESP control through MCP

Operates Klaviyo, Resend, beehiiv, Mailchimp, Omnisend, or Nitrosend through connectors with pre-send gates.

Deliverability triage

Covers authentication, reputation, content, inbox placement, and warming.

Industry playbooks

Includes tactics for 19 verticals, from ecommerce and SaaS to nonprofits and publishing.

Compliance checks

Treats GDPR, CAN-SPAM, CASL, CCPA, and the Australian Spam Act as gates before sending.

How to get it

  1. 1Run
    git clone https://github.com/CosmoBlk/email-marketing-bible.git ~/.claude/skills/email-marketing-bible
  2. 2Audit and build
    "Audit my Klaviyo account for a DTC skincare brand doing $2M/year. I have a
    welcome series, abandoned cart, and one weekly newsletter. What am I missing,
    and build me whatever flow would earn the most first."
  3. 3Fix a problem
    "My emails are landing in Gmail promotions and opens dropped from 22% to 14%
    over three months. What is going on and how do I fix it?"
  4. 4De-slop
    "Here is a draft welcome email. Make it sound like a person, not an AI, and
    keep it on our brand voice."
  5. 5Design
    "Design a launch email for a premium coffee brand. List 15 directions first,
    I will pick. Then build the pick as MJML and run a critic loop on the render."

README

Email Marketing Bible

The AI email automation skill for Claude, ChatGPT, and any agent. v2.7, 8 September 2026.

Install it and your AI stops guessing about email. It audits your setup, builds flows from a prompt, drafts copy in your voice, directs email design instead of accepting the model's defaults, tells you why you are in spam, and runs your ESP through MCP with a hard rule that nothing blasts without your say-so.

Built from 908 sources, the experience of running SmartrMail (~28,000 customers, 6 billion emails, acquired 2022), and three months of running Nitrosend's own sending through agents. 19 chapters, 19 industry playbooks, 47 curated email designs. Free and open source.

Install

git clone https://github.com/CosmoBlk/email-marketing-bible.git ~/.claude/skills/email-marketing-bible

Works wherever you run skills: Claude Code, Claude Desktop, and any agent that reads the skill format.

Why this exists

In 2026 the job changed. Agents build the campaign, segment the audience, draft the copy and stage the send; the marketer directs. That only works if the agent runs on real benchmarks and hard guardrails. This skill is that discipline layer: the patterns that repeat across industries, the mistakes that destroy deliverability, the anti-slop rules for copy and design, and the send-safety gates that keep one prompt from mailing the wrong thing to your whole list.

What the skill does

TaskWhat it does
Run email automationBuild welcome, cart, post-purchase and win-back flows from a prompt, then review exits, timing and copy before anything goes live
Audit your setupReview flows, segments, deliverability and compliance, and say what is missing
Draft and de-slop copyWrite with proven frameworks (PAS, AIDA, BAB) and strip the AI tells before send
Direct email designSeed strings for divergence, a critic loop that scores screenshots, chained image and video models, delivery by subtraction; output as inbox-safe MJML or React Email
Drive your ESP from AIOperate Klaviyo, Resend, beehiiv, Mailchimp, Omnisend or Nitrosend through MCP and connectors, with pre-send gates and field-tested operating rules
Fix deliverabilityStep-by-step triage covering authentication, reputation, content and the AI-mediated inbox
Pull industry benchmarksOpen, click, conversion and revenue-per-email figures by vertical
Compare platformsHonest comparison by list size, budget and whether an agent can drive it
Review complianceGDPR, CAN-SPAM, CASL, CCPA and the Australian Spam Act as a gate before any send
Write cold emailSequences with proper infrastructure separation, warming and personalisation
WhatsApp, SMS and RCSThe real cost models, consent rules and where each channel pays off

How to use it

Talk to your AI like an email marketing consultant.

Audit and build:

"Audit my Klaviyo account for a DTC skincare brand doing $2M/year. I have a
welcome series, abandoned cart, and one weekly newsletter. What am I missing,
and build me whatever flow would earn the most first."

Fix a problem:

"My emails are landing in Gmail promotions and opens dropped from 22% to 14%
over three months. What is going on and how do I fix it?"

De-slop:

"Here is a draft welcome email. Make it sound like a person, not an AI, and
keep it on our brand voice."

Design:

"Design a launch email for a premium coffee brand. List 15 directions first,
I will pick. Then build the pick as MJML and run a critic loop on the render."

The skill has two parts: an operating manual for when the AI is acting (building, sending, diagnosing, designing) and a dense reference (benchmarks, frameworks, playbooks).

What is inside

19 chapters

#ChapterWhat you get
1The FundamentalsWhy email wins, the stack, key metrics, the AI-mediated inbox
2Building Your ListOrganic growth, popups, opt-in, spam traps, validation
3Segmentation & PersonalisationEngagement tiers, AI-built segments, 1:1 content from behaviour
4The Emails That Make MoneyWelcome, cart, post-purchase, win-back, and building flows with AI
5Copywriting That ConvertsSubject lines, frameworks, CTAs, and the anti-slop copy protocol
6Design & TechnicalDesigning for two readers, tokens and modules, dark mode, accessibility, the anti-default ban list, and directing the agent (Discover, Define, Deliver)
7DeliverabilitySPF, DKIM, DMARC, BIMI, reputation, warming, autonomous-send safety
8Testing & OptimisationA/B testing, significance, send-time, testing AI-assisted email
9Analytics & MeasurementKPIs by type, attribution, querying your data with AI
10Compliance & PrivacyGDPR, CAN-SPAM, CASL, CCPA, AU Spam Act, AI accountability
11Industry PlaybooksTactics for 19 verticals (see below)
12Choosing Your PlatformHonest comparison, including which tools an agent can actually drive
13Cold Email & B2B OutboundInfrastructure, writing, follow-up, AI in outbound
14WhatsApp BusinessThe cost model and where it pays off, per-user caps, quality tiers, opt-in and geo-branching, the AI-chatbot rule
15SMS & RCSTCPA, 10DLC and CTIA compliance, quiet hours, a realistic read on RCS, and AI in two-way messaging
16AI & Agentic MarketingSupervised autonomy, agent preflight gates, data governance, non-deterministic optimisation, what the vendors shipped, and field notes from agent-run sending
17Company Case StudiesHow Casper, Morning Brew, Duolingo, Spotify, and others use email
18Expert DirectoryThe practitioners referenced throughout, who to follow and why
19Best Email Designs 202647 hand-curated emails with notes on why each works and what to steal

Plus four appendices: benchmarks by industry, frequency guide, marketing calendar, and methodology.

19 industry playbooks

Ecommerce DTC · SaaS B2B · SaaS B2C · Newsletter & Creator · Agency · Nonprofit · Healthcare · Financial Services · Real Estate · Travel & Hospitality · Education · Professional Services · Retail · Events · B2B Manufacturing · Restaurant & Food · Fitness · Media & Publishing · Marketplace & Platform

Expert contributors

Insights from practitioners including Chad S. White (Zeta Global), Joanna Wiebe (Copyhackers), Chase Dimond (Structured Agency), Nathan Barry (Kit), Ann Handley (MarketingProfs), Troy Ericson, Tyler Denk (beehiiv), Ben Settle, and many others. Full directory in Chapter 18.

What changed in v2.7

  • An AI email design method, Discover, Define, Deliver, adapted for email from Anshu Chimala's Lenny's Newsletter piece: seed strings, broad-first direction picking, a screenshot critic loop, chained image and video models, delivery by subtraction.
  • Five practitioners on designing with AI added to the expert directory (Anshu Chimala, Karri Saarinen, Ryo Lu, Jenny Wen, Lee Munroe), taking it to 49.
  • Field notes from three months of running an ESP through agents, in the skill and in Chapter 16.
  • Model references updated to the September 2026 state.
  • The skill file cut by a fifth; the send-safety gates are unchanged.

Read the full guide

The complete Email Marketing Bible is at emailmarketingskill.com, searchable and browsable, with all 19 chapters and 4 appendices, plus a free PDF.

Research

908 sources across industry reports (Litmus, Klaviyo, HubSpot, Salesforce, Validity), practitioner blogs, podcasts and transcripts, platform documentation, and community discussions, refreshed mid-2026 with a focus on AI email automation.

Contributing

Found an error, better data, or a missing tactic? Issues and PRs welcome.

License

MIT.


Built by George Hartley. Follow for updates.

Files in the repo

Repository payload4 top-level entries
  • .gitignore
  • LICENSE
  • README.md
  • SKILL.md

Discussion (0)

Ask about usage, or say what you built with it

Sign in to join the discussion.

No comments yet. Be the first to say what this is good for.

More skills

Vincentwei1021/
anything2explainer

Topic in, narrated explainer video out. A Claude Code / Codex skill that turns any topic into a black-canvas motion-graphics explainer video with TTS voiceover, subtitles and a chapter progress bar. Chinese or English; every frame drawn in code with Remotion.

666

Open-source AI job search: scan job portals, evaluate listings into a structured A-H report with a global 1-5 score, tailor your CV, track applications — runs locally in your AI coding CLI (Claude Code, Codex, OpenCode, Antigravity…)

71k

Taste-Skill - gives your AI good taste. stops the AI from generating boring, generic slop

86k

Agent skill for beautiful, verifiable architecture, workflow, sequence, data-flow, and lifecycle diagrams—self-contained HTML with motion and crisp export.

57k