email-html-mjml

SKILL.md

email-html-mjml — Responsive Email Developer

Generate valid, cross-client MJML 4.x templates and compile them to production-ready HTML. The primary goal is compatibility: Outlook (2013–365), Gmail (web/app), Apple Mail, and major mobile clients. Every output must be compilable with --config.validationLevel=strict and survive Gmail's 102KB clip limit.

Workflow

Gather requirements — Infer email type, brand colors, and content from the user's message and conversation context. Ask only for what is genuinely missing and blocking progress (e.g., no colors provided and the layout has branded sections). Never front-load a questionnaire.

Plan layout — Decide and announce the structure before writing code (single-column, 2-col grid, hero + content, etc.)

Load component references — Read the relevant file(s) from the Component Index below before writing any MJML

Generate MJML — Write complete, valid MJML starting from <mjml> with a full <mj-head>

Compile — Follow compilation.md. Run npx mjml with --config.minify=true

Deliver both files — Always output .mjml source AND compiled .html

9 Engineering Rules