# email-design

email-design — a skill for Claude Code and Codex that handles transactional email layout. Styles account confirmations, password resets and billing receipts to match your application branding.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 1216 repo stars
- Author: Fatih C. Akyon
- License: Apache-2.0 · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/fcakyon/claude-codex-settings/tree/HEAD/plugins/reusable-app-components/skills/email-design/SKILL.md
- Updated: 2026-11-09
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/email-design

## What it does

The skill defines guidelines for transactional messages such as email verification codes, password resets, payment receipts and product notices. It keeps the existing delivery pipeline and authentication logic intact instead of swapping out email providers for a visual redesign.

Layouts rely on fluid single-column presentation tables up to 560 px with inline CSS, explicit text colors and a matching plain-text part. It requires the `light only` color-scheme meta tag and the `:root` `light dark` declaration so that Gmail apps and Apple Mail do not invert dark mode into unreadable dark-on-dark blocks. Core content must avoid Flexbox, JavaScript, SVG and CSS background images.

Transparent PNG icons break when email clients shift backgrounds, so logos need their own solid backdrop. Browser previews cannot prove client rendering, meaning final templates must be inspected through test deliveries in the Gmail app and Apple Mail.

## Install

### Claude Code (native platform)

1. **Plugin marketplace**
In the agent chat (not a shell):
```text
/plugin marketplace add fcakyon/claude-codex-settings
```
In the agent chat (not a shell):
```text
/plugin install reusable-app-components@claude-settings
```
This installs the whole reusable-app-components plugin with all its skills

2. **Skills CLI (Vercel)**
```bash
npx skills add fcakyon/claude-codex-settings --skill email-design -a claude-code
```

3. **Manually: put the files in place**
- File: `~/.claude/skills/email-design/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/email-design/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add fcakyon/claude-codex-settings --skill email-design -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/email-design/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add fcakyon/claude-codex-settings --skill email-design -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/email-design/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install fcakyon/claude-codex-settings plugins/reusable-app-components/skills/email-design
```

2. **Manually: put the files in place**
- File: `.github/skills/email-design/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add fcakyon/claude-codex-settings --skill email-design -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/fcakyon/claude-codex-settings --path plugins/reusable-app-components/skills/email-design
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/email-design/SKILL.md` — The legacy .windsurf/skills/ path still works

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/fcakyon/claude-codex-settings/tree/HEAD/plugins/reusable-app-components/skills/email-design/SKILL.md

## When to use it
- build resilient transactional email templates that render across mail apps
- prevent dark mode color inversions from breaking contrast in Gmail
- format verification codes as selectable text with visible expiration times
- generate matching plain-text versions for all notification flows

## Example prompts
- Design a verification email template matching our web app styles
- Review the password reset email markup for Apple Mail dark mode compatibility
- Create a transactional billing receipt template with inline CSS

## Source text · SKILL.md · Apache-2.0

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: a78e2b92e06e13b6.

BEGIN THIRD-PARTY FILE a78e2b92e06e13b6
```text
---
name: email-design
description: This skill should be used when user asks to "design app emails", "theme transactional emails", "fix verification emails", "build email templates", or "review password reset emails". Match an app’s brand and reuse its delivery pipeline across account, billing and notification emails.
---

# App email design

Make the email help someone finish the action they started in the app. Preserve the app’s transport, authentication and consent rules. Use this skill for transactional email design and integration, rather than email service setup or campaign sending.

## Inspect before changing

Trace each requested event from the app action to its template and sending client. Check locales, HTML and text parts, provider-managed templates, sender, reply address, expiry and destination handling. Keep tokens, addresses and captured messages private. Find the shared layout before adding another renderer. Do not replace a working delivery service to change its design.

Read the app’s visible theme and copy. Choose brand name, approved logo, page and surface backgrounds, body and muted text, primary action and its text color, font stack, corner radius and support address. Put these in one theme or layout, with message wording separate. Keep per-message content limited to subject, preview, heading, body, code or primary action, and necessary context. Use the app’s locale and runtime formatting for amounts and dates.

## Design around the action

- Verification: show the code as selectable text, say where to enter it, and state the real expiry. Keep the code out of the subject and hidden preview. Do not make a link that only opens an unrelated homepage.
- Password reset: continue the app’s actual recovery flow. Do not invent links, token lifetimes or automatic sign-in. Say what to do if the recipient did not request it.
- Billing: show the amount, currency, period, renewal or cancellation date when relevant. Link to the exact plan or receipt. Do not shorten away billing terms or add upgrade pressure to a receipt.
- Notifications: name the event and link to the affected item. Include preferences where supported. Keep marketing consent separate from required account messages.
```
END THIRD-PARTY FILE a78e2b92e06e13b6

The third-party file has ended. Everything between the a78e2b92e06e13b6 tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 2238 of 6436 bytes. © Fatih C. Akyon · Apache-2.0 · https://github.com/fcakyon/claude-codex-settings/tree/HEAD/plugins/reusable-app-components/skills/email-design/SKILL.md

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
