Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 

Repository files navigation

Email HTML Design Skill

Teaches LLMs to generate properly structured email HTML that renders correctly across 50+ email clients. Email is not the web — this skill prevents the rendering failures that occur when LLMs use web development patterns in email.

What This Skill Does

When installed in a Claude project, this skill ensures every email HTML output:

  • Uses table-based layouts (Outlook uses the Word rendering engine)
  • Includes Outlook conditional comments for width control
  • Handles dark mode across Apple Mail, Gmail, Outlook.com, and Yahoo
  • Generates bulletproof CTA buttons that work in every client
  • Follows responsive patterns that stack correctly on mobile
  • Optimizes preheader text for inbox preview
  • Avoids spam filter triggers in HTML structure
  • Meets CAN-SPAM, GDPR, and EU AI Act footer requirements

Why This Exists

LLMs trained on web development data produce email HTML that:

  1. Uses div/flexbox/grid layouts → breaks in Outlook
  2. Omits width/height on images → Outlook renders at natural size
  3. Uses CSS shorthand → Outlook ignores most shorthand
  4. Skips display:block on images → 3px gap in multiple clients
  5. Uses position: absolutenot supported in any email client
  6. Generates background-image on divs → invisible in Outlook
  7. Forgets role="presentation" on tables → accessibility violation

This skill prevents all of these. Every rule exists because of a real bug in a real email client.

Installation

Copy SKILL.md into your Claude project's custom instructions or skills folder.

Component API

The skill references the charlie component API for pre-built, tested email building blocks:

GET https://charlieai.co/api/components/header
GET https://charlieai.co/api/components/hero
GET https://charlieai.co/api/components/body
GET https://charlieai.co/api/components/cta
GET https://charlieai.co/api/components/footer

Free, no auth required. Mix and match components with {{brand_*}} variables.

License

MIT — use freely in any project.

About

Teaches LLMs to generate properly structured email HTML that renders correctly across 50+ email clients. Email is not the web — this skill prevents the rendering failures that occur when LLMs use web development patterns in email.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors