email-best-practices について
Email Best Practicesは、到達性、コンプライアンス、アクセシビリティを考慮したメール作成のリファレンススキルです。アプリ開発チーム向けに、メールの計画、認証、同意、送信の信頼性、イベント処理、リスト管理を案内します。
主な機能
- 01メールの計画と種類の選定
- 02到達性とDNS認証のガイダンス
- 03同意取得とコンプライアンスの実践
- 04再試行と冪等送信の指針
- 05配信イベントとWebhookの処理
- 06アクセシビリティとリスト管理の指針
活用シーン
- 01アプリのトランザクションメールの計画
- 02ニュースレター登録と同意の設定
- 03メール到達や迷惑メールの問題調査
- 04再試行、バウンス、配信イベントの処理
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ resend/ email-best-practices --skill email-best-practicesインストール後、Claude Code で/email-best-practicesを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
README.md.github/workflows/sync-skills.ymlreferences/email-capture.mdemail-types.mdmarketing-emails.mdcompliance.mdaccessibility.mddeliverability.mdlist-management.mdsending-reliability.mdtransactional-emails.mdwebhooks-events.mdtransactional-email-catalog.mdtests/README.mdtests/scenarios/01-spam-deliverability.md04-webhook-bounce-handling.md02-multi-region-compliance.md05-new-saas-email-plan.md03-retry-idempotency.md詳細
メールのベストプラクティス
到達性が高く、法令に準拠し、ユーザーにとって使いやすいメールを作成するためのガイダンスです。
アーキテクチャの概要
[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]
クイックリファレンス
| 必要な作業 | 参照先 |
|---|---|
| SPF/DKIM/DMARC を設定する、迷惑メールの問題を解決する | 到達性 |
| パスワードリセット、OTP、確認メールを作成する | トランザクションメール |
| アプリに必要なメールを計画する | トランザクションメールカタログ |
| ニュースレターの登録フォームを作成する、メールアドレスを検証する | メールアドレスの収集 |
| ニュースレターやプロモーションを送信する | マーケティングメール |
| CAN-SPAM/GDPR/CASL に準拠する | 法令遵守 |
| トランザクションメールとマーケティングメールのどちらかを判断する | メールの種類 |
| 再試行、冪等性、エラーに対処する | 送信の信頼性 |
| 配信イベントを処理する、Webhook を設定する | Webhook とイベント |
| バウンス、苦情、抑制リストを管理する | リスト管理 |
| メールをアクセシブルにする(スクリーンリーダー、代替テキスト、コントラスト) | アクセシビリティ |
ここから始めましょう
新しいアプリですか? まずカタログでアプリに必要なメール(パスワードリセット、確認メールなど)を計画し、最初のメールを送信する前に到達性(DNS 認証)を設定してください。
迷惑メールの問題がありますか? まず到達性を確認してください。認証の問題が最も一般的な原因です。Gmail/Yahoo は認証されていないメールを拒否します。
マーケティングメールですか? 次の手順に従ってください。メールアドレスの収集(同意の取得)→ 法令遵守(法的要件)→ マーケティングメール(ベストプラクティス)。
本番環境での送信に備えますか? 信頼性を高めましょう。送信の信頼性(再試行+冪等性)→ Webhook とイベント(配信の追跡)→ リスト管理(バウンスへの対処)。
アクセシビリティが必要ですか?
ほとんどのメールは、基本的なアクセシビリティチェックに合格しません。アクセシビリティで、lang/dir、プレゼンテーション用テーブル、見出し、代替テキスト、<title>、コントラストについて確認してください。
コメント
Markdown 対応