Install the belt CLI skill: npx skills add belt-sh/cli
Email Design
Design high-converting marketing emails with AI-generated visuals via inference.sh CLI.
Quick Start
Requires inference.sh CLI (belt). Install instructions
belt login
# Generate email header banner
belt app run infsh/html-to-image --input '{
"html": "<div style=\"width:600px;height:250px;background:linear-gradient(135deg,#667eea,#764ba2);display:flex;align-items:center;justify-content:center;font-family:system-ui;color:white;text-align:center\"><div><h1 style=\"font-size:36px;margin:0\">Spring Sale — 30% Off</h1><p style=\"font-size:18px;opacity:0.9\">This weekend only</p></div></div>"
}'
Email Width & Layout
| Constraint |
Value |
Why |
| Max width |
600px |
Gmail, Outlook rendering standard |
| Mobile width |
320-414px |
Responsive fallback |
| Single column |
Preferred |
Better mobile rendering |
| Two column |
Use sparingly |
Breaks on many clients |
| Image width |
600px max, 300px for 2-col |
Retina: provide 2x (1200px) |
| Font size (body) |
14-16px |
Below 14px is hard to read on mobile |
| Font size (heading) |
22-28px |
Must be scannable |
| Line height |
1.5 |
Readability on all devices |
The Inverted Pyramid Layout
The most effective email layout funnels attention to a single CTA:
┌──────────────────────────────────┐
│ HEADER IMAGE │ ← Brand/visual hook
│ (600 x 200-300) │
├──────────────────────────────────┤
│ │
│ Headline (one line) │ ← What's this about
│ │
│ 2-3 sentences of body copy │ ← Why should I care
│ explaining the value. │
│ │
│ ┌──────────────┐ │
│ │ CTA BUTTON │ │ ← One clear action
│ └──────────────┘ │
│ │
├──────────────────────────────────┤
│ Footer: Unsubscribe link │
└──────────────────────────────────┘
Subject Lines
Formulas That Work
| Formula |
Example |
Open Rate Impact |
| Number + benefit |
"5 ways to cut your build time in half" |
High |
| Question |
"Are you still deploying on Fridays?" |
High |
| How-to |
"How to automate your reports in 3 steps" |
Medium-High |
| Urgency (genuine) |
"Last day: 30% off annual plans" |
High (if real) |
| Personalized |
"[Name], your weekly report is ready" |
Very High |
| Curiosity gap |
"The one feature our users can't stop talking about" |
Medium-High |
Rules
| Rule |
Value |
| Length |
30-50 characters (mobile truncates at ~35) |
| Preview text |
First 40-100 chars after subject — design this intentionally |
| Emoji |
Max 1, at start or end, test with your audience |
| ALL CAPS |
Never — triggers spam filters |
| Spam trigger words |
Avoid: "free", "act now", "limited time", "click here" in subject |
| Personalization |
[First name] in subject lifts open rates 20%+ |
Preview Text
The preview text appears after the subject line in the inbox. Don't waste it.
❌ "View this email in your browser" (default, wasted space)
❌ "Having trouble viewing this?" (no one cares)
✅ Subject: "5 ways to cut build time"
Preview: "Number 3 saved us 6 hours per week"
✅ Subject: "Your monthly report is ready"
Preview: "Revenue up 23% — here's what drove it"
Email Types
Welcome Email (Automated, Day 0)
| Element |
Content |
| Subject |
"Welcome to [Product] — here's what's next" |
| Header |
Brand image or product screenshot |
| Body |
3-4 sentences: what they signed up for, what to expect, one quick win |
| CTA |
"Complete your setup" or "Try your first [action]" |
| Timing |
Immediately after signup |
Promotional / Campaign
| Element |
Content |
| Subject |
Benefit-focused, urgency if real |
| Header |
Hero image showing the offer/outcome |
| Body |
Problem → solution → offer → deadline |
| CTA |
"Get 30% Off" or "Start Free Trial" |
| Urgency |
Real deadline, not fake scarcity |
Product Update / Changelog
| Element |
Content |
| Subject |
"New: [Feature name] is here" |
| Header |
Screenshot or visual of the feature |
| Body |
What's new, why it matters, how to use it |
| CTA |
"Try [feature]" |
Transactional (Receipts, Confirmations)
| Rule |
Why |
| Clear purpose in subject |
"Your order #1234 is confirmed" |
| Minimal design |
Don't confuse with marketing |
| Key info above the fold |
Order number, amount, date |
| No promotional content (mostly) |
CAN-SPAM allows some, but keep minimal |
Header Image Design
# Welcome email header
belt app run infsh/html-to-image --input '{
"html": "<div style=\"width:600px;height:250px;background:linear-gradient(135deg,#2d3436,#636e72);display:flex;align-items:center;padding:40px;font-family:system-ui;color:white\"><div><p style=\"font-size:14px;text-transform:uppercase;letter-spacing:2px;opacity:0.7;margin:0\">Welcome to</p><h1 style=\"font-size:42px;margin:8px 0 0;font-weight:800\">DataFlow</h1><p style=\"font-size:18px;opacity:0.8;margin-top:4px\">Your data, automated</p></div></div>"
}'
# Sale / promotional header
belt app run infsh/html-to-image --input '{
"html": "<div style=\"width:600px;height:300px;background:linear-gradient(135deg,#e74c3c,#c0392b);display:flex;align-items:center;justify-content:center;font-family:system-ui;color:white;text-align:center\"><div><p style=\"font-size:20px;opacity:0.9;margin:0\">This Weekend Only</p><h1 style=\"font-size:72px;margin:8px 0;font-weight:900\">30% OFF</h1><p style=\"font-size:18px;opacity:0.8\">All annual plans. Ends Sunday.</p></div></div>"
}'
# Feature announcement header with AI visual
belt app run falai/flux-dev-lora --input '{
"prompt": "clean modern email header banner, abstract flowing data visualization, dark blue gradient background, subtle glowing nodes and connections, tech aesthetic, minimal, no text, 600x250 equivalent",
"width": 1200,
"height": 500
}'
CTA Buttons
| Rule |
Value |
| Width |
200-300px, not full width |
| Height |
44-50px minimum (tap target) |
| Color |
High contrast with background |
| Text |
Action verb + outcome: "Start Free Trial" |
| Shape |
Rounded corners (4-8px border-radius) |
| Placement |
Above the fold, repeated at bottom for long emails |
| Quantity |
ONE primary CTA per email |
Bulletproof Buttons
HTML buttons render differently across email clients. Use the "bulletproof button" technique (VML for Outlook, HTML/CSS for everything else):
<!-- Bulletproof button (works everywhere including Outlook) -->
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td align="center" bgcolor="#22c55e" style="border-radius:6px;">
<a href="https://yoursite.com/action" target="_blank"
style="font-size:16px;font-family:sans-serif;color:#ffffff;
text-decoration:none;padding:12px 24px;display:inline-block;
font-weight:bold;">
Start Free Trial
</a>
</td>
</tr>
</table>
Mobile Optimization
| Rule |
Why |
| Single column layout |
Multi-column breaks on mobile |
| Font minimum 14px |
Smaller is unreadable |
| CTA button minimum 44px tall |
Apple/Android tap target |
| Images scale to 100% width |
Prevent horizontal scroll |
| Stack elements vertically |
Side-by-side breaks on narrow screens |
| Test on Gmail app, Apple Mail, Outlook |
The big 3 email clients |
60%+ of emails are opened on mobile. Design mobile-first.
Deliverability Checklist
| Factor |
Rule |
| Image-to-text ratio |
Max 40% images, 60% text (spam filters flag image-heavy emails) |
| Alt text on images |
Always — images blocked by default in many clients |
| Unsubscribe link |
Required by law (CAN-SPAM, GDPR) — make it easy to find |
| From name |
Recognizable person or brand name |
| Reply-to |
Real address, not no-reply@ (hurts deliverability) |
| List hygiene |
Remove bounces, clean inactive subscribers quarterly |
| SPF/DKIM/DMARC |
Technical authentication — set up once, critical for inbox |
Common Mistakes
| Mistake |
Problem |
Fix |
| No preview text |
Shows "View in browser" or random code |
Set preview text intentionally |
| Image-only emails |
Blocked images = blank email + spam risk |
60%+ text, alt text on images |
| Multiple CTAs |
Decision paralysis, lower click rate |
One primary CTA per email |
| Tiny text |
Unreadable on mobile |
Minimum 14px body, 22px headings |
| no-reply@ sender |
Hurts deliverability, feels impersonal |
Use real reply address |
| No mobile testing |
Broken layout for 60%+ of readers |
Test on Gmail app + Apple Mail |
| Missing unsubscribe |
Illegal (CAN-SPAM) + spam complaints |
Clear unsubscribe link in footer |
| Over-designing |
Email clients render CSS inconsistently |
Simple layouts, inline styles |
| Fake urgency |
Erodes trust, trains users to ignore |
Only use real deadlines |
Related Skills
npx skills add inference-sh/skills@landing-page-design
npx skills add inference-sh/skills@ai-image-generation
npx skills add inference-sh/skills@prompt-engineering
Browse all apps: belt app list
1---
2name: email-design
3description: "Email marketing design with layout patterns, subject line formulas, and deliverability rules. Covers welcome sequences, promotional emails, transactional templates, and mobile optimization. Use for: email marketing, newsletter design, drip campaigns, email templates, transactional emails. Triggers: email design, email template, email marketing, newsletter design, email layout, email campaign, drip campaign, welcome email, promotional email, transactional email, email subject line, email header image, email banner"
4allowed-tools: Bash(belt *)
5metadata:
6 source: https://skillmd.com/skills/101-skills/email-design
7---
8
9> **Install the belt CLI skill:** `npx skills add belt-sh/cli`
10
11# Email Design
12
13Design high-converting marketing emails with AI-generated visuals via [inference.sh](https://inference.sh) CLI.
14
15## Quick Start
16
17> Requires inference.sh CLI (`belt`). [Install instructions](https://raw.githubusercontent.com/inference-sh/skills/refs/heads/main/cli-install.md)
18
19```bash
20belt login
21
22# Generate email header banner
23belt app run infsh/html-to-image --input '{
24 "html": "<div style=\"width:600px;height:250px;background:linear-gradient(135deg,#667eea,#764ba2);display:flex;align-items:center;justify-content:center;font-family:system-ui;color:white;text-align:center\"><div><h1 style=\"font-size:36px;margin:0\">Spring Sale — 30% Off</h1><p style=\"font-size:18px;opacity:0.9\">This weekend only</p></div></div>"
25}'
26```
27
28
29## Email Width & Layout
30
31| Constraint | Value | Why |
32|-----------|-------|-----|
33| **Max width** | 600px | Gmail, Outlook rendering standard |
34| **Mobile width** | 320-414px | Responsive fallback |
35| **Single column** | Preferred | Better mobile rendering |
36| **Two column** | Use sparingly | Breaks on many clients |
37| **Image width** | 600px max, 300px for 2-col | Retina: provide 2x (1200px) |
38| **Font size (body)** | 14-16px | Below 14px is hard to read on mobile |
39| **Font size (heading)** | 22-28px | Must be scannable |
40| **Line height** | 1.5 | Readability on all devices |
41
42### The Inverted Pyramid Layout
43
44The most effective email layout funnels attention to a single CTA:
45
46```
47┌──────────────────────────────────┐
48│ HEADER IMAGE │ ← Brand/visual hook
49│ (600 x 200-300) │
50├──────────────────────────────────┤
51│ │
52│ Headline (one line) │ ← What's this about
53│ │
54│ 2-3 sentences of body copy │ ← Why should I care
55│ explaining the value. │
56│ │
57│ ┌──────────────┐ │
58│ │ CTA BUTTON │ │ ← One clear action
59│ └──────────────┘ │
60│ │
61├──────────────────────────────────┤
62│ Footer: Unsubscribe link │
63└──────────────────────────────────┘
64```
65
66## Subject Lines
67
68### Formulas That Work
69
70| Formula | Example | Open Rate Impact |
71|---------|---------|-----------------|
72| Number + benefit | "5 ways to cut your build time in half" | High |
73| Question | "Are you still deploying on Fridays?" | High |
74| How-to | "How to automate your reports in 3 steps" | Medium-High |
75| Urgency (genuine) | "Last day: 30% off annual plans" | High (if real) |
76| Personalized | "[Name], your weekly report is ready" | Very High |
77| Curiosity gap | "The one feature our users can't stop talking about" | Medium-High |
78
79### Rules
80
81| Rule | Value |
82|------|-------|
83| **Length** | 30-50 characters (mobile truncates at ~35) |
84| **Preview text** | First 40-100 chars after subject — design this intentionally |
85| **Emoji** | Max 1, at start or end, test with your audience |
86| **ALL CAPS** | Never — triggers spam filters |
87| **Spam trigger words** | Avoid: "free", "act now", "limited time", "click here" in subject |
88| **Personalization** | [First name] in subject lifts open rates 20%+ |
89
90### Preview Text
91
92The preview text appears after the subject line in the inbox. Don't waste it.
93
94```
95❌ "View this email in your browser" (default, wasted space)
96❌ "Having trouble viewing this?" (no one cares)
97
98✅ Subject: "5 ways to cut build time"
99 Preview: "Number 3 saved us 6 hours per week"
100
101✅ Subject: "Your monthly report is ready"
102 Preview: "Revenue up 23% — here's what drove it"
103```
104
105## Email Types
106
107### Welcome Email (Automated, Day 0)
108
109| Element | Content |
110|---------|---------|
111| Subject | "Welcome to [Product] — here's what's next" |
112| Header | Brand image or product screenshot |
113| Body | 3-4 sentences: what they signed up for, what to expect, one quick win |
114| CTA | "Complete your setup" or "Try your first [action]" |
115| Timing | Immediately after signup |
116
117### Promotional / Campaign
118
119| Element | Content |
120|---------|---------|
121| Subject | Benefit-focused, urgency if real |
122| Header | Hero image showing the offer/outcome |
123| Body | Problem → solution → offer → deadline |
124| CTA | "Get 30% Off" or "Start Free Trial" |
125| Urgency | Real deadline, not fake scarcity |
126
127### Product Update / Changelog
128
129| Element | Content |
130|---------|---------|
131| Subject | "New: [Feature name] is here" |
132| Header | Screenshot or visual of the feature |
133| Body | What's new, why it matters, how to use it |
134| CTA | "Try [feature]" |
135
136### Transactional (Receipts, Confirmations)
137
138| Rule | Why |
139|------|-----|
140| Clear purpose in subject | "Your order #1234 is confirmed" |
141| Minimal design | Don't confuse with marketing |
142| Key info above the fold | Order number, amount, date |
143| No promotional content (mostly) | CAN-SPAM allows some, but keep minimal |
144
145## Header Image Design
146
147```bash
148# Welcome email header
149belt app run infsh/html-to-image --input '{
150 "html": "<div style=\"width:600px;height:250px;background:linear-gradient(135deg,#2d3436,#636e72);display:flex;align-items:center;padding:40px;font-family:system-ui;color:white\"><div><p style=\"font-size:14px;text-transform:uppercase;letter-spacing:2px;opacity:0.7;margin:0\">Welcome to</p><h1 style=\"font-size:42px;margin:8px 0 0;font-weight:800\">DataFlow</h1><p style=\"font-size:18px;opacity:0.8;margin-top:4px\">Your data, automated</p></div></div>"
151}'
152
153# Sale / promotional header
154belt app run infsh/html-to-image --input '{
155 "html": "<div style=\"width:600px;height:300px;background:linear-gradient(135deg,#e74c3c,#c0392b);display:flex;align-items:center;justify-content:center;font-family:system-ui;color:white;text-align:center\"><div><p style=\"font-size:20px;opacity:0.9;margin:0\">This Weekend Only</p><h1 style=\"font-size:72px;margin:8px 0;font-weight:900\">30% OFF</h1><p style=\"font-size:18px;opacity:0.8\">All annual plans. Ends Sunday.</p></div></div>"
156}'
157
158# Feature announcement header with AI visual
159belt app run falai/flux-dev-lora --input '{
160 "prompt": "clean modern email header banner, abstract flowing data visualization, dark blue gradient background, subtle glowing nodes and connections, tech aesthetic, minimal, no text, 600x250 equivalent",
161 "width": 1200,
162 "height": 500
163}'
164```
165
166## CTA Buttons
167
168| Rule | Value |
169|------|-------|
170| **Width** | 200-300px, not full width |
171| **Height** | 44-50px minimum (tap target) |
172| **Color** | High contrast with background |
173| **Text** | Action verb + outcome: "Start Free Trial" |
174| **Shape** | Rounded corners (4-8px border-radius) |
175| **Placement** | Above the fold, repeated at bottom for long emails |
176| **Quantity** | ONE primary CTA per email |
177
178### Bulletproof Buttons
179
180HTML buttons render differently across email clients. Use the "bulletproof button" technique (VML for Outlook, HTML/CSS for everything else):
181
182```html
183<!-- Bulletproof button (works everywhere including Outlook) -->
184<table cellpadding="0" cellspacing="0" border="0">
185 <tr>
186 <td align="center" bgcolor="#22c55e" style="border-radius:6px;">
187 <a href="https://yoursite.com/action" target="_blank"
188 style="font-size:16px;font-family:sans-serif;color:#ffffff;
189 text-decoration:none;padding:12px 24px;display:inline-block;
190 font-weight:bold;">
191 Start Free Trial
192 </a>
193 </td>
194 </tr>
195</table>
196```
197
198## Mobile Optimization
199
200| Rule | Why |
201|------|-----|
202| Single column layout | Multi-column breaks on mobile |
203| Font minimum 14px | Smaller is unreadable |
204| CTA button minimum 44px tall | Apple/Android tap target |
205| Images scale to 100% width | Prevent horizontal scroll |
206| Stack elements vertically | Side-by-side breaks on narrow screens |
207| Test on Gmail app, Apple Mail, Outlook | The big 3 email clients |
208
209**60%+ of emails are opened on mobile.** Design mobile-first.
210
211## Deliverability Checklist
212
213| Factor | Rule |
214|--------|------|
215| Image-to-text ratio | Max 40% images, 60% text (spam filters flag image-heavy emails) |
216| Alt text on images | Always — images blocked by default in many clients |
217| Unsubscribe link | Required by law (CAN-SPAM, GDPR) — make it easy to find |
218| From name | Recognizable person or brand name |
219| Reply-to | Real address, not no-reply@ (hurts deliverability) |
220| List hygiene | Remove bounces, clean inactive subscribers quarterly |
221| SPF/DKIM/DMARC | Technical authentication — set up once, critical for inbox |
222
223## Common Mistakes
224
225| Mistake | Problem | Fix |
226|---------|---------|-----|
227| No preview text | Shows "View in browser" or random code | Set preview text intentionally |
228| Image-only emails | Blocked images = blank email + spam risk | 60%+ text, alt text on images |
229| Multiple CTAs | Decision paralysis, lower click rate | One primary CTA per email |
230| Tiny text | Unreadable on mobile | Minimum 14px body, 22px headings |
231| no-reply@ sender | Hurts deliverability, feels impersonal | Use real reply address |
232| No mobile testing | Broken layout for 60%+ of readers | Test on Gmail app + Apple Mail |
233| Missing unsubscribe | Illegal (CAN-SPAM) + spam complaints | Clear unsubscribe link in footer |
234| Over-designing | Email clients render CSS inconsistently | Simple layouts, inline styles |
235| Fake urgency | Erodes trust, trains users to ignore | Only use real deadlines |
236
237## Related Skills
238
239```bash
240npx skills add inference-sh/skills@landing-page-design
241npx skills add inference-sh/skills@ai-image-generation
242npx skills add inference-sh/skills@prompt-engineering
243```
244
245Browse all apps: `belt app list`
246