email-best-practices

作成者: resend

配信可能でコンプライアンスに準拠したユーザーフレンドリーなメールシステムを構築するための包括的なガイダンス。認証設定(SPF/DKIM/DMARC)、スパムトラブルシューティング、メールがスパムフォルダに入らないようにするための配信性のベストプラクティスをカバー。トランザクションメール(パスワードリセット、OTP、確認メール)や、適切な同意ワークフローを備えたマ

npx skills add https://github.com/resend/email-best-practices --skill email-best-practices

Email Best Practices

Guidance for building deliverable, compliant, user-friendly emails.

Architecture Overview

[User] → [Email Form] → [Validation] → [Double Opt-In]
                                              ↓
                                    [Consent Recorded]
                                              ↓
[Suppression Check] ←──────────────[Ready to Send]
        ↓
[Idempotent Send + Retry] ──────→ [Email API]
                                       ↓
                              [Webhook Events]
                                       ↓
              ┌────────┬────────┬─────────────┐
              ↓        ↓        ↓             ↓
         Delivered  Bounced  Complained  Opened/Clicked
                       ↓        ↓
              [Suppression List Updated]
                       ↓
              [List Hygiene Jobs]

Quick Reference

Need to...See
Set up SPF/DKIM/DMARC, fix spam issuesDeliverability
Build password reset, OTP, confirmationsTransactional Emails
Plan which emails your app needsTransactional Email Catalog
Build newsletter signup, validate emailsEmail Capture
Send newsletters, promotionsMarketing Emails
Ensure CAN-SPAM/GDPR/CASL complianceCompliance
Decide transactional vs marketingEmail Types
Handle retries, idempotency, errorsSending Reliability
Process delivery events, set up webhooksWebhooks & Events
Manage bounces, complaints, suppressionList Management
Make emails accessible (screen readers, alt text, contrast)Accessibility

Start Here

New app? Start with the Catalog to plan which emails your app needs (password reset, verification, etc.), then set up Deliverability (DNS authentication) before sending your first email.

Spam issues? Check Deliverability first—authentication problems are the most common cause. Gmail/Yahoo reject unauthenticated emails.

Marketing emails? Follow this path: Email Capture (collect consent) → Compliance (legal requirements) → Marketing Emails (best practices).

Production-ready sending? Add reliability: Sending Reliability (retry + idempotency) → Webhooks & Events (track delivery) → List Management (handle bounces).

Accessibility? Most emails fail basic accessibility checks. See Accessibility for lang/dir, presentational tables, headings, alt text, <title>, and contrast.

resendのその他のスキル

send-email
resend
Resend APIを使用したトランザクションメールおよび一括メール配信。単一エンドポイントまたはバッチエンドポイントに対応。単一エンドポイントは添付ファイルやスケジュール設定を含む個別メールに使用し、バッチエンドポイントは1リクエストで2~100通の異なるメールを送信してAPI呼び出しを削減。べき等性キー(<event-type>/<entity-id>形式)を実装し、リトライ時の重複送信を防止、24時間で有効期限切れ。429(レート制限)および500(サーバーエラー)応答のみ指数バックオフでリトライし、400/422のバリデーションエラーは修正してから再試行。
templates
resend
ResendのメールテンプレートをAPI経由で作成、更新、公開、削除、一覧表示する際、またはテンプレート変数を定義する際、ドラフトと…の違いを理解する際に使用します。
design-audit
resend
Resendダッシュボードのデザインシステム整合性を監査します。ユーザーが「デザイン監査」「デザイン整合性」「ダッシュボードデザイン監査」と言った場合、または…について尋ねた場合にここにルーティングされます。
marketing-pages
resend
Resendコードベース内でマーケティング/公開ページを作成、更新、編集、または削除する際に使用します。ページ構造、コンポーネント再利用のルール、および…をカバーします。
resend-design-skills
resend
Resendのデザインリソースが必要な場合に使用します。ブランドガイドライン、ビジュアルアイデンティティ、UIコンポーネント、デザイントークン、マーケティングページパターンにルーティングします。
resend-design-system
resend
ResendコードベースでUIを構築・変更する際に使用します。すべてのsrc/ui/…に対するコンポーネントAPI、バリアントオプション、デザイントークン、構成パターンを提供します。
react-email
resend
Reactコンポーネントを使用して、クライアントセーフなスタイリングとプレビューテストを備えたHTMLメールを構築・送信します。TypeScript対応のコンポーネントベースのメール開発で、コアレイアウトコンポーネント(Html、Body、Container、Section、Row、Column)とコンテンツ要素(Heading、Text、Button、Image、CodeBlock)を備えています。ピクセルベースのプリセットを使用したTailwindコンポーネントによるTailwind CSSスタイリング。メールクライアント互換性のためにテーブルベースのレイアウトが必要です。localhost:3000でのローカル開発サーバープレビューとライブ編集機能を提供。
resend-migrate
resend
SendGrid、Mailgun、またはPostmarkからResendへの移行時に使用します。@sendgrid/mail、sgMail、SENDGRID_API_KEY、mailgun、postmarkのインポートを検出し、ルーティングします…