email-craft

Designs HTML product emails using table layouts, inline CSS, and dark-mode handling.

1|Updated Aug 17, 2026
One-click install
npx skills add https://github.com/NalinDalal/skillset --skill email-craft-nalindalal
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: email-craft
Source: https://github.com/NalinDalal/skillset/tree/main/skills/ui/email-craft
Command: npx skills add https://github.com/NalinDalal/skillset --skill email-craft-nalindalal

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? HTML emails render inconsistently across clients like Gmail, Outlook, and Apple Mail because there is no shared rendering engine, so web-style layouts break unpredictably. This Skill encodes the constraints of email clients and the design principles for decision-oriented product emails. ## Core Features & Use Cases - Email client constraints: Enforces table-based layout, inlined CSS, 600px max width, dark-mode overrides, and plaintext fallbacks. - Information architecture template: Provides a proven hierarchy (header, stats, hero item, compact rows, insight, actions, footer) with tier definitions for what belongs in the email versus linking out. - Component library: Defines composable components such as emailHeader, emailStats, emailHeroJob, emailJobRow, emailInsight, emailOutreach, emailActionList, and emailFooter with tokens for color, typography, and spacing. - Use Case: When building a daily digest email for a job-matching product, use this Skill to structure one hero match with reasoning, 3-5 compact rows, and action-driven CTAs that render correctly in Gmail and Outlook. ## Quick Start Use the email-craft skill to design a daily digest HTML email with one hero item, compact secondary rows, and a single primary CTA.

Frequently Asked Questions about email-craft

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I build HTML emails that work in Outlook and Gmail?▼

Use table-based layout with role="presentation" instead of divs, inline all CSS, and cap width at 600px with a single column. Add MSO conditional handling and test across Gmail web/app, Outlook Win/Mac, and Apple Mail before sending.

How to handle dark mode in HTML emails?▼

Use a @media (prefers-color-scheme: dark) style block to force specific values, since Gmail and Outlook auto-invert colors. Override score pills with dark backgrounds, invert primary CTAs to light backgrounds, and shift text colors to light tones like #f5f5f7.

What width should an HTML email be?▼

HTML emails should use a 600px maximum width with a single column layout. Inner tables should use 100% width rather than fixed pixel widths so the design stacks correctly on mobile screens under 600px.

Why does my email layout break in Outlook?▼

Outlook uses the Word rendering engine, which ignores divs, modern CSS, and style blocks for layout. Fix this by using table-based or hybrid layouts, inlining all CSS, and avoiding fixed pixel widths on inner tables.

What are common HTML email design mistakes to avoid?▼

Avoid stacking multiple cards, using gradients, generic CTAs like "View" or "Learn more", showing all items instead of linking to a dashboard, missing plaintext versions, no dark-mode handling, and images without alt text.