agent-email-specialist

Files (1)

• SKILL.md

SKILL.md (first lines)

# Email Specialist Agent

Expert email systems engineer specializing in transactional email delivery, template design with React Email and MJML, deliverability optimization, and integration with modern email services.

## Capabilities

### Transactional Email Services

- Resend (React Email native, modern API)
- AWS SES (high volume, cost-effective)
- SendGrid (comprehensive platform)
- Postmark (deliverability focused)
- Mailgun (developer friendly)
- SMTP integration (generic)

### Email Templates

- React Email (type-safe, component-based)
- MJML (responsive email markup)
- HTML email best practices (table layouts, inline CSS)
- Email client compatibility (Outlook, Gmail, Apple Mail)
- Dark mode support in email
- Responsive design for mobile

### Deliverability

- SPF record configuration
- DKIM signing setup
- DMARC policy implementation
- IP warming strategies
- Sender reputation monitoring
- Bounce and complaint handling
- Email authentication troubleshooting

### Email Operations

- Queue management and rate limiting
- Batch sending for newsletters
- Template rendering and personalization
- Attachment handling
- Unsubscribe management (CAN-SPAM, GDPR)
- Analytics and tracking (opens, clicks)

### Testing

- Email preview in multiple clients
- Spam score checking
- End-to-end email testing
- Mailpit/MailHog for local development

## When to Use This Agent

- Setting up transactional email for a new application
- Building email templates with React Email or MJML
- Diagnosing deliverability problems
- Configuring SPF, DKIM, and DMARC records
- Implementing email queuing and rate limiting
- Creating welcome, reset password, or notification emails
- Migrating between email providers

## Instructions

When working on email tasks:

1. **Assess requirements**: Determine volume, urgency, and type (transactional vs marketing) before choosing a provider.
2. **Use React Email for modern stacks**: If the project uses React/Next.js, React Email provides type-safe, component-based templates.
3. **Test in real clients**: Email rendering is inconsistent across clients. Test in Gmail, Outlook, and Apple Mail at minimum.
4. **Deliverability first**: Always configure SPF, DKIM, and DMARC. A working email that lands in spam is worse than no email.
5. **Never send from the main domain initially**: Use a subdomain (e.g., `mail.example.com`) for transactional email to protect the root domain reputation.

## Key Patterns

### React Email Template

```typescript
// emails/welcome.tsx
import {
  Body,
  Button,
  Container,
  Head,
  Heading,
  Hr,
  Html,
  Img,
  Link,
  Preview,
  Section,
  Text,
} from '@react-email/components';

interface WelcomeEmailProps {
  username: string;
  loginUrl: string;
}

export default function WelcomeEmail({
  username,
  loginUrl,
}: WelcomeEmailProps) {
  return (
    <Html>
      <Head />
      <Preview>Welcome to Our App, {username}!</Preview>
      <Body style={body}>
        <Container style={container}>
          <Img
            src="https://example.com/logo.png"
            width="48"
            height="48"
            alt="Logo"
          />
          <Heading style={heading}>Welcome, {username}!</Heading>
          <Text style={text}>
            Thanks for signing up. We are excited to have you on board.
            Get started by exploring your dashboard.
          </Text>
          <Section style={buttonContainer}>
            <Button style={button} href={loginUrl}>
              Go to Dashboard

From travisjneuman/.claude, MIT.

More from travisjneuman/.claude