Skip to content
Back to search

email-campaigns

Design, build, and send beautiful HTML email campaigns via Resend. Handles asset hosting (images + GIFs on your own CDN), the pre-built email HTML component library (frost-glass cards, hero image, video blocks with blurred backgrounds, CTA buttons, footer), GIF optimization from MP4 source video, and sending via the Resend API. Use when asked to "create an email", "draft a marketing email", "send a campaign", "make an email sequence", or "build an email with Resend". Proactively suggest when the user mentions sending marketing emails, launching a feature via email, or designing a newsletter.

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/irinabuht12-oss--email-campaigns-claude/badge.svg)](/listings/irinabuht12-oss--email-campaigns-claude)

HTML

<a href="/listings/irinabuht12-oss--email-campaigns-claude"><img src="/api/listings/irinabuht12-oss--email-campaigns-claude/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
git clone https://github.com/irinabuht12-oss/email-campaigns-claude.git

# Install as a skill
mkdir -p ~/.claude/skills/email-campaigns
cp email-campaigns-claude/SKILL.md ~/.claude/skills/email-campaigns/SKILL.md

Then in any Claude Code session: `/email-campaigns`

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.

SKILL.md · Manifest · 297 lines

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

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. ---
  2. name: email-campaigns
  3. version: 1.0.0
  4. description: |
  5. Design, build, and send beautiful HTML email campaigns via Resend. Handles asset hosting (images + GIFs on your own CDN), the pre-built email HTML component library (frost-glass cards, hero image, video blocks with blurred backgrounds, CTA buttons, footer), GIF optimization from MP4 source video, and sending via the Resend API. Use when asked to "create an email", "draft a marketing email", "send a campaign", "make an email sequence", or "build an email with Resend".
  6. Proactively suggest when the user mentions sending marketing emails, launching a feature via email, or designing a newsletter.
  7. allowed-tools:
  8. - Bash
  9. - Read
  10. - Write
  11. - Edit
  12. - Grep
  13. - Glob
  14. ---
  15. # Email Campaigns
  16. Build modern, on-brand marketing emails and send them via Resend. This skill encodes a complete pattern: asset hosting, reusable HTML components, GIF tooling, and the Resend send pipeline.
  17. ## 1. Asset hosting — use your own site as a CDN
  18. **Setup once.** In a Next.js or any static-hosted project, create a folder served at the site root:
  19. ```
  20. <project>/public/email-assets/
  21. <campaign-name>/
  22. hero.png
  23. demo.gif
  24. ```
  25. Anything in `public/` is served at `https://yourdomain.com/email-assets/...`. Commit + push = instant CDN. No Cloudinary, no S3.
  26. **Rules for email-safe assets:**
  27. - Naming: lowercase, dashes only (`hero-image.jpg` ✅, `Hero Image.jpg` ❌)
  28. - Images: JPG/PNG, ≤ 1 MB, max 600px wide
  29. - GIFs: ≤ 1.5 MB, max 720px wide, 12-15 fps, keep under 8 seconds
  30. - Video: MP4 in same folder, but NEVER embed `<video>` — always use GIF thumbnail linking to MP4
  31. - Version filenames instead of overwriting (`hero-v2.jpg`) — email clients cache aggressively
  32. **Before sending:** swap all local paths to absolute URLs (`https://yourdomain.com/email-assets/...`). Relative paths work in browser preview but break in recipients' inboxes.
  33. ## 2. Design system — reusable blocks
  34. Use this building-block inventory. Copy from a previous campaign, don't redesign from scratch.
  35. ### Outer shell
  36. ```html
  37. <body style="margin:0; padding:0; background-color:#ffffff;
  38. font-family:-apple-system,BlinkMacSystemFont,'Segoe UI',Helvetica,Arial,sans-serif;">
  39. <div style="display:none; max-height:0; overflow:hidden; font-size:1px; line-height:1px; color:#fff;">
  40. [PREHEADER — 1 sentence, shown in inbox preview]
  41. </div>
  42. <table width="100%" cellpadding="0" cellspacing="0" border="0" style="background-color:#ffffff;">
  43. <tr><td align="center" style="padding:32px 16px;">
  44. <table width="560" cellpadding="0" cellspacing="0" border="0"
  45. style="max-width:560px; width:100%;">
  46. <!-- MAIN CARD -->
  47. <tr><td>
  48. <table width="100%" cellpadding="0" cellspacing="0" border="0"
  49. style="background-color:#f7fbfe;
  50. background-image: url('data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHdpZHRoPSIyMDAiIGhlaWdodD0iMjAwIj48ZmlsdGVyIGlkPSJuIj48ZmVUdXJidWxlbmNlIHR5cGU9ImZyYWN0YWxOb2lzZSIgYmFzZUZyZXF1ZW5jeT0iMC44NSIgbnVtT2N0YXZlcz0iMiIgc3RpdGNoVGlsZXM9InN0aXRjaCIvPjwvZmlsdGVyPjxyZWN0IHdpZHRoPSIxMDAlIiBoZWlnaHQ9IjEwMCUiIGZpbHRlcj0idXJsKCNuKSIgb3BhY2l0eT0iMC4wNiIvPjwvc3ZnPg=='),
  51. linear-gradient(90deg, #edf6fd 0%, #f6fbfe 50%, #fcfdfe 100%);
  52. border-radius:4px;
  53. box-shadow: 0 2px 8px rgba(24,24,27,0.06), 0 8px 24px rgba(24,24,27,0.04);
  54. overflow:hidden;">
  55. <!-- sections go here -->
  56. </table>
  57. </td></tr>
  58. </table>
  59. </td></tr>
  60. </table>
  61. </body>
  62. ```
  63. Key tokens:
  64. - **Card bg:** light sky gradient + 6% SVG noise texture for depth (subtle grain). Gradient direction `90deg` = left→right.
  65. - **Card shadow:** layered soft shadow, no border
  66. - **Card radius:** 4px (tight corners feel modern)
  67. ### Header image
  68. Full-width image flush with card top. Crop the top 3/4 of a wide image (1376×576 cropped from 1376×768) for hero; use the bottom 1/3 (256px) as a footer image inside the card.
  69. ### Logo cards (frost-glass)
  70. Five logos distributed across full card width via `width="20%"` columns. Each card 72×72, light fill (#f4f4f7 gradient), soft shadow, 3px radius.
  71. ### Hero title + body
  72. ```html
  73. <h1 style="font-size:26px; font-weight:700; color:#18181b; letter-spacing:-0.5px;">...</h1>
  74. <p style="font-size:15px; line-height:1.65; color:#3f3f46;">...</p>
  75. ```
  76. ### Feature list with black bullets (not green checks)
  77. Keep bullets black `&bull;` in a 20px cell, text 15px. Avoid green check pills — they look dated.
  78. ### Video block (frost-glass with blurred bg)
  79. Pre-blur your brand hero image with ffmpeg to use as a colorful bed behind videos:
  80. ```bash
  81. ffmpeg -y -i header.png -vf "boxblur=luma_radius=30:luma_power=3" header_blur.png
  82. ```
  83. Then:
  84. ```html
  85. <a href="LANDING-URL">
  86. <p>Video title</p>
  87. <table width="100%">
  88. <tr><td style="background-image:url('https://yourdomain.com/email-assets/header_blur.png');
  89. background-size:cover; border-radius:3px; padding:14px;
  90. box-shadow:0 4px 14px rgba(24,24,27,0.1);">
  91. <table width="100%">
  92. <tr><td style="background-color:rgba(255,255,255,0.55);
  93. backdrop-filter:blur(12px);
  94. -webkit-backdrop-filter:blur(12px);
  95. border:1px solid rgba(255,255,255,0.6);
  96. border-radius:3px; padding:10px;
  97. box-shadow:inset 0 1px 0 rgba(255,255,255,0.5);">
  98. <img src="GIF-URL" width="475" style="display:block; width:100%;
  99. max-width:475px; border-radius:3px;">
  100. </td></tr>
  101. </table>
  102. </td></tr>
  103. </table>
  104. </a>
  105. ```
  106. In Apple Mail/iOS: `backdrop-filter` renders real glass. In Gmail/Outlook: the pre-blurred image underneath sells the effect on its own.
  107. ### CTA button
  108. Black pill, 4px radius, 14px 24px padding, optional small logo inline:
  109. ```html
  110. <table width="100%"><tr><td align="center"
  111. style="border-radius:4px; background-color:#18181b;">
  112. <a href="LANDING-URL" style="display:block; padding:14px 24px;
  113. font-size:14px; font-weight:600; color:#fff;
  114. text-decoration:none;">
  115. <img src="LOGO" width="20" height="20"
  116. style="display:inline-block; vertical-align:middle;
  117. margin-right:8px; border-radius:3px;" alt="">
  118. <span style="vertical-align:middle;">Connect your accounts &rarr;</span>
  119. </a>
  120. </td></tr></table>
  121. ```
  122. Place one CTA immediately after the first proof video (highest conversion moment) and one at the bottom.
  123. ### Typography scale
  124. - H1: 26px
  125. - Body/features/video titles: 15px
  126. - Section labels/footer: 13px
  127. - CTA button: 14px
  128. Stick to this. No more than 3 sizes.
  129. ## 3. GIF optimization workflow
  130. For each screen recording:
  131. ```bash
  132. # Convert MP4 → optimized GIF (720px, 15fps, 2x speed, trim to 8s)
  133. ffmpeg -y -i source.mp4 -t 8 \
  134. -vf "setpts=0.5*PTS,fps=15,scale=720:-1:flags=lanczos,split[s0][s1];\
  135. [s0]palettegen=max_colors=256[p];\
  136. [s1][p]paletteuse=dither=sierra2_4a" \
  137. -loop 0 output.gif
  138. # Check file size — should be under 1.5 MB
  139. ls -lh output.gif
  140. ```
  141. If too big:
  142. - Drop to 12fps
  143. - Reduce width to 600px
  144. - Trim to 5-6 seconds
  145. - Drop palette to 128 colors, use `dither=bayer:bayer_scale=5`
  146. If too low quality:
  147. - Bump to 720-900px
  148. - 256 colors with `sierra2_4a` dither
  149. - Accept 1.5-2 MB ceiling
  150. ## 4. Sending via Resend
  151. ### Setup (once per project)
  152. ```bash
  153. npm install resend
  154. ```
  155. Env var: `RESEND_API_KEY=re_...` (get from resend.com dashboard)
  156. From domain: verify your sending domain in Resend settings first (DNS records take ~15 min to propagate). Use `hello@yourdomain.com`, not a free provider.
  157. ### Send a single test email
  158. ```js
  159. // send.mjs
  160. import { Resend } from 'resend';
  161. import fs from 'fs';
  162. const resend = new Resend(process.env.RESEND_API_KEY);
  163. const html = fs.readFileSync('./email.html', 'utf-8');
  164. const { data, error } = await resend.emails.send({
  165. from: 'Ira <hello@get-ryze.ai>',
  166. to: 'you@example.com',
  167. subject: 'Claude Connector for Google/Meta Ads is live',
  168. html,
  169. // Optional plain-text fallback
  170. text: 'We released the Claude connector. Connect in 1 click: https://...',
  171. });
  172. console.log(error ?? data);
  173. ```
  174. Run: `node send.mjs`. Always send to yourself first.
  175. ### Send to a list (batches)
  176. Resend rate-limits at 10 req/sec (free) or 100 req/sec (paid). For larger lists use their batch API:
  177. ```js
  178. await resend.batch.send(
  179. recipients.map(email => ({
  180. from: 'Ira <hello@get-ryze.ai>',
  181. to: email,
  182. subject: '...',
  183. html,
  184. }))
  185. );
  186. ```
  187. Up to 100 emails per batch call. Chunk your list accordingly.
  188. ### Sequences / drip campaigns
  189. For a 3-email sequence (day 0, day 3, day 7), use a cron + a sent-state table in Postgres/Supabase:
  190. ```js
  191. // Pseudo
  192. const dueToday = await db.campaigns.findMany({
  193. where: { scheduled_date: today, status: 'pending' }
  194. });
  195. for (const c of dueToday) {
  196. await resend.emails.send({ ...c });
  197. await db.campaigns.update({ where: { id: c.id }, data: { status: 'sent' } });
  198. }
  199. ```
  200. Resend has webhooks for `email.delivered`, `email.opened`, `email.clicked` — use them to trigger the next email in the sequence rather than fixed timers.
  201. ## 5. Pre-send checklist
  202. Before you hit send on a real list:
  203. - [ ] All asset URLs are absolute (`https://...`), not relative (`/email-assets/...`)
  204. - [ ] Preheader text set (first hidden div) — this is the inbox preview line
  205. - [ ] Subject line tested for deliverability (no ALL CAPS, no exclamation spam)
  206. - [ ] Every image has meaningful `alt` text
  207. - [ ] Every link has `target="_blank"`
  208. - [ ] GIFs under 2 MB each, total email under 5 MB
  209. - [ ] Tested in at least: Gmail web, Gmail mobile, Apple Mail, Outlook
  210. - [ ] Unsubscribe link in footer (required by CAN-SPAM / GDPR)
  211. - [ ] Sent one test to yourself — clicked every link
  212. - [ ] `from` address is on a verified domain in Resend
  213. ## 6. Conversion best practices
  214. - **One primary CTA** — repeated twice (mid-email + bottom). Don't dilute with secondary actions.
  215. - **Video first, text second** — a 3-second GIF shows product faster than 3 paragraphs.
  216. - **Specificity wins** — "Connect in 1 click" > "Get started". "30-second setup" > "Easy to install".
  217. - **Claim + proof** — every claim near a visual (GIF, screenshot, or logo strip showing integrations).
  218. - **Low-friction reply CTA** — "Reply 'Guide' and I'll send you X" is high-intent and cheap to fulfill.
  219. - **Send Tuesday-Thursday, 9-11am recipient-local**. Avoid Monday (full inboxes) and weekends (low open).
  220. ## 7. Template starter
  221. To bootstrap a new campaign, copy the most recent working HTML from your repo (e.g. `public/email-assets/preview/claude-connector.html`) and edit in place. Keep the preview file checked in alongside the campaign folder:
  222. ```
  223. public/email-assets/2026-05-launch/
  224. hero.png
  225. demo.gif
  226. preview.html
  227. ```
  228. Preview locally at `http://localhost:3000/email-assets/2026-05-launch/preview.html`.
  229. ## 8. What NOT to do
  230. - ❌ Don't use `<video>` tags — blocked in Gmail/Outlook
  231. - ❌ Don't use CSS grid or flexbox — broken in Outlook. Use nested `<table>`s.
  232. - ❌ Don't use web fonts — most clients strip them. Stick to system font stack.
  233. - ❌ Don't use background images on the `<body>` if you need them on mobile Gmail — it ignores body bg. Put color inside the main card.
  234. - ❌ Don't embed MP4 directly — always GIF preview → link to external MP4.
  235. - ❌ Don't send without testing — render one in Litmus/Mailtrap or just send to yourself on 3 clients.
README.md · README · 66 lines

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

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. # email-campaigns-claude
  2. Beautiful HTML email campaigns with [Resend](https://resend.com) and [Claude Code](https://claude.com/claude-code).
  3. A Claude Code skill that encodes a complete pattern for building and sending modern marketing emails — asset hosting, reusable design blocks (frost-glass cards, video blocks with blurred backgrounds, CTA buttons), GIF optimization, and the Resend send pipeline.
  4. ![demo](./demo.gif)
  5. ## What's inside
  6. - **[SKILL.md](SKILL.md)** — the full skill, drop into `~/.claude/skills/email-campaigns/` and invoke via `/email-campaigns`
  7. - **[examples/claude-connector.html](examples/claude-connector.html)** — real production email built with this pattern. Open in a browser to see the rendered result.
  8. ## Install as a Claude Code skill
  9. ```bash
  10. # Clone
  11. git clone https://github.com/irinabuht12-oss/email-campaigns-claude.git
  12. # Install as a skill
  13. mkdir -p ~/.claude/skills/email-campaigns
  14. cp email-campaigns-claude/SKILL.md ~/.claude/skills/email-campaigns/SKILL.md
  15. ```
  16. Then in any Claude Code session: `/email-campaigns`
  17. ## What you'll learn
  18. - **Asset hosting** — turn your own Vercel/Netlify `public/` folder into a free email CDN (no Cloudinary bill)
  19. - **Design system** — copy-paste blocks: hero image, frost-glass logo cards, video thumbnails with blurred color backgrounds, dark CTA buttons
  20. - **GIF pipeline** — ffmpeg one-liners to convert MP4 screen recordings into email-safe GIFs (under 2 MB, 15fps, sensibly trimmed)
  21. - **Resend integration** — single-send, batch-send, drip sequences with webhooks
  22. - **Pre-send checklist** — absolute URLs, preheader, alt text, client testing
  23. ## Design tokens at a glance
  24. | Element | Value |
  25. |---|---|
  26. | Card corner radius | 3px |
  27. | Card shadow | `0 2px 8px rgba(24,24,27,.06), 0 8px 24px rgba(24,24,27,.04)` |
  28. | Typography scale | 26px / 15px / 13px |
  29. | Max card width | 560px |
  30. | Primary action | Black pill CTA, repeated 2x |
  31. | Background | Soft sky-blue gradient + 6% SVG noise texture |
  32. ## Example
  33. The `examples/` folder has a complete real-world email (the Ryze AI × Claude Connector launch) showing every block used in context.
  34. ![Example](./examples/preview.png)
  35. Open `examples/claude-connector.html` in any browser for the live preview.
  36. ## Pull the numbers for the email from your ad accounts
  37. The example campaign in `examples/` announces the Ryze connector. If you want Claude to read your own Google Ads, Meta Ads, GA4 or Search Console data while it writes (results, winners, the stat for the hero), add the free Ryze MCP once:
  38. ```
  39. claude mcp add ryze --transport http https://connector.get-ryze.ai/mcp
  40. ```
  41. In claude.ai, Claude Desktop or Cursor: Settings › Connectors › Add custom connector, paste `https://connector.get-ryze.ai/mcp`. [Setup guide →](https://www.get-ryze.ai/how-to-connect-claude-to-google-meta-ads-mcp) · [48 more Claude marketing skills →](https://github.com/irinabuht12-oss/marketing-skills)
  42. ## License
  43. MIT

Ratings and comments

Sign in to rate this skill.

Sign in

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