Anthropic ClaudeEC・マーケティング⭐ リポ 0品質スコア 50/100

email-systems

Name: email-systems
Author: sickn33

メールはあらゆるマーケティングチャネルの中で最も高いROIを誇り、1ドルの投資に対して36ドルのリターンをもたらします。それにもかかわらず、多くのスタートアップはパーソナライズのない一斉配信やスパムフォルダ行きといった場当たり的な運用に留まっています。このスキルは、メールシステムを戦略的に設計・最適化し、マーケティング効果を最大限に引き出すための実践的なサポートを提供します。

description の原文を見る

Email has the highest ROI of any marketing channel. $36 for every $1 spent. Yet most startups treat it as an afterthought - bulk blasts, no personalization, landing in spam folders.

SKILL.md 本文

メールシステム

メールはあらゆるマーケティングチャネルの中で最も高いROIを持っています。1ドル使うごとに36ドルの収益があります。それでもほとんどのスタートアップはメールを後付けのように扱っています。一括配信、個人化なし、スパムフォルダへの到着です。

このスキルは機能するトランザクショナルメール、コンバージョンするマーケティングオートメーション、受信トレイに到達するデリバラビリティ、およびスケールするインフラストラクチャの決定をカバーしています。

原則

トランザクショナル vs マーケティングの分離 | 説明: トランザクショナルメール（パスワードリセット、領収書）は100%のデリバリーが必要です。マーケティングメール（ニュースレター、プロモーション）は優先度が低いです。トランザクショナルデリバラビリティを保護するために、別のIPアドレスとプロバイダを使用してください。 | 例: 良い例: Postmark経由のパスワードリセット、ConvertKit経由のマーケティング | 悪い例: すべてのメールが1つのSendGridアカウント経由
パーミッションがすべて | 説明: あなたからのメールを受け取りたいと言った人だけにメールを送ってください。マーケティング用のダブルオプトイン。簡単にアンサブスクライブできます。リストを容赦なく整理してください。悪いリストはデリバラビリティを破壊します。 | 例: 良い例: 確認済みサブスクリプション + ワンクリックアンサブスクライブ | 悪い例: スクレイプされたメールリスト、隠されたアンサブスクライブ、購入されたコンタクト
デリバラビリティはインフラストラクチャ | 説明: SPF、DKIM、DMARCはオプションではありません。新しいIPをウォームアップしてください。バウンスレートを監視してください。デリバラビリティは技術的セットアップと良い行動を通じて獲得されます。 | 例: 良い例: すべてのDNSレコードが設定されており、専用IPが4週間ウォームアップされている | 悪い例: 無料ティアの共有IP、認証レコードなし
1メール、1つのゴール | 説明: 各メールはちょうど1つの目的と1つのCTAを持つべきです。複数の要求は何もクリックされないことを意味します。明確な単一アクション。 | 例: 良い例: 「ここをクリックしてメールを確認してください」（1つのボタン） | 悪い例: 「メール確認、ブログをチェック、Twitterをフォロー、友達を紹介...」
タイミングと頻度が重要 | 説明: 間違った時間 = 低いオープンレート。頻繁すぎる = アンサブスクライブ。ユーザーに設定を選択させてください。送信時間をテストしてください。受信トレイの疲労を尊重してください。 | 例: 良い例: 火曜日午前10時（ユーザーのタイムゾーン）の週次ダイジェスト、プリファレンスセンター | 悪い例: ランダムな時間の毎日のメール、頻度を減らす方法なし

パターン

トランザクショナルメールキュー

再試行ロジックと監視を備えたすべてのトランザクショナルメールをキューに入れます

使用時期: 重要なメール（パスワードリセット、領収書、確認）を送信する場合

// メール送信をリクエストでブロックしない
await queue.add('email', {
  template: 'password-reset',
  to: user.email,
  data: { resetToken, expiresAt }
}, {
  attempts: 3,
  backoff: { type: 'exponential', delay: 2000 }
});

メールイベント追跡

配信、開封、クリック、バウンス、苦情を追跡します

使用時期: メールキャンペーンまたはトランザクショナルフローの場合

ライフサイクルを追跡:
- Queued: メールがシステムに入った
- Sent: プロバイダに引き渡された
- Delivered: 受信トレイに到達した
- Opened: 受信者が表示した
- Clicked: 受信者が関与した
- Bounced: 永続的な失敗
- Complained: スパムとしてマークされた

テンプレートバージョニング

ロールバックとA/Bテスト用にメールテンプレートをバージョン管理します

使用時期: 本番メールテンプレートを変更する場合

templates/
  password-reset/
    v1.tsx (current)
    v2.tsx (testing 10%)
    v1-deprecated.tsx (archived)

# 新しいバージョンを段階的にデプロイ
# 完全ロールアウト前にメトリクスを監視

バウンス処理ステートマシン

バウンスと苦情のWebhookを処理して、送信者の評判を保護します

使用時期: バウンスと苦情のWebhookを処理する場合

switch (bounceType) {
  case 'hard':
    await markEmailInvalid(email);
    break;
  case 'soft':
    await incrementBounceCount(email);
    if (count >= 3) await markEmailInvalid(email);
    break;
  case 'complaint':
    await unsubscribeImmediately(email);
    break;
}

React メールコンポーネント

再利用可能なReactコンポーネントでメールを構築します

使用時期: メールテンプレートを作成する場合

import { Button, Html } from '@react-email/components';

export default function WelcomeEmail({ userName }) {
  return (
    <Html>
      <h1>Welcome {userName}!</h1>
      <Button href="https://app.com/start">
        Get Started
      </Button>
    </Html>
  );
}

プリファレンスセンター

ユーザーがメールの頻度とトピックを制御できるようにします

使用時期: マーケティングまたは通知システムを構築する場合

プリファレンス:
☑ 製品更新（週次）
☑ 新機能（月次）
☐ マーケティングプロモーション
☑ アカウント通知（常時）

# すべての送信でプリファレンスを尊重
# GDPR準拠に必須

危険な部分

SPF、DKIM、またはDMARCレコードがない

重大度: 重大

状況: 認証なしでメールを送信しています。メールがスパムフォルダに入っています。オープンレートが低いです。なぜかわかりません。DNSレコードがセットアップされていなかったことが判明しました。

症状:

メールがスパムに入っている
低いデリバラビリティレート
mail-tester.com スコアが8未満
DMARCレポートが受け取られていない

これが壊れる理由: メール認証（SPF、DKIM、DMARC）は受信サーバーに対してあなたが正当であることを伝えます。これらなしでは、スパマーのように見えます。最新のメールプロバイダはますます3つすべてを要求しています。

推奨される修正:

# 必須のDNSレコード:

## SPF (Sender Policy Framework)
TXTレコード: v=spf1 include:_spf.google.com include:sendgrid.net ~all

## DKIM (DomainKeys Identified Mail)
メールプロバイダが提供するTXTレコード
メールへの暗号署名を追加

## DMARC (Domain-based Message Authentication)
TXTレコード: v=DMARC1; p=quarantine; rua=mailto:dmarc@yourdomain.com

# セットアップを確認:
- mail-tester.comにテストメールを送信
- MXToolboxでレコード検証を確認
- DMARCレポートを監視

トランザクショナルメール用の共有IP

重大度: 高

状況: パスワードリセットがスパムに入っています。メールプロバイダの無料ティアを使用しています。共有IP上の他の顧客がスパムのためにフラグが立てられました。あなたの評判は協会によって台無しにされました。

症状:

トランザクショナルメールがスパムに入っている
配信の一貫性がない
マーケティングとトランザクショナルに同じプロバイダを使用

これが壊れる理由: 共有IPは評判を共有しています。1つの悪い行為者は誰もが影響を受けます。重要なトランザクショナルメールの場合、独自のIPまたは厳格な共有IPポリシーを持つプロバイダが必要です。

推奨される修正:

# トランザクショナルメール戦略:

## オプション1: 専用IP（高ボリューム）
- プロバイダから専用IPを取得
- ゆっくりウォームアップ（1日100件から開始）
- 一貫したボリュームを維持

## オプション2: トランザクショナルのみのプロバイダ
- Postmark（非常に厳格、優れた評判）
- 高い基準を備えた共有プールを含む

### 懸念事項の分離:
- トランザクショナル: PostmarkまたはResend
- マーケティング: ConvertKitまたはCustomer.io
- マーケティングとトランザクショナルを混ぜないこと

バウンス通知を処理しない

重大度: 高

状況: 何度も同じ無効なアドレスにメール送信しています。バウンスレートが上昇しています。メールプロバイダがアカウントを一時停止すると脅迫しています。リストの40%が無効です。

症状:

バウンスレートが2%以上
バウンス用のWebhookハンドラがない
同じメールが何度も失敗している

これが壊れる理由: バウンスは送信者の評判に損害を与えます。メールプロバイダはバウンスレートを追跡します。2%以上で、スパマーのように見え始めます。無効なアドレスはすぐに削除する必要があります。

推奨される修正:

# バウンス処理要件:

### ハードバウンス:
最初に発生した時点で削除
無効なアドレス、ドメインが存在しない

### ソフトバウンス:
72時間で3回再試行
3回の失敗後、ハードバウンスとして扱う

### 実装:
```typescript
// バウンス用のWebhookハンドラ
app.post('/webhooks/email', (req, res) => {
  const event = req.body;
  if (event.type === 'bounce') {
    await markEmailInvalid(event.email);
    await removeFromAllLists(event.email);
  }
});

監視:

キャンペーンごとにバウンスレートを追跡バウンスレートが1%を超える場合はアラート


### アンサブスクライブリンクがない、または隠されている

重大度: 重大

状況: ユーザーはアンサブスクライブできないため、スパムとしてマークしています。スパム苦情が増加しています。CAN-SPAM違反。メールプロバイダがアカウントを一時停止します。

症状:
- 隠されたアンサブスクライブリンク
- マルチステップのアンサブスクライブプロセス
- List-Unsubscribeヘッダなし
- 高いスパム苦情レート

これが壊れる理由:
アンサブスクライブできないユーザーはスパムとしてマークします。スパム苦情は評判にダメージを与えます。また、それは文字通り違法です。CAN-SPAM、GDPRはすべて明確なアンサブスクライブを要求します。

推奨される修正:

アンサブスクライブ要件:

表示:

メールフッターの上部
クリアなテキスト、隠されていない
見えないようにスタイルされていない

ワンクリック:

リンクは直接アンサブスクライブ
ログインは不要
「確認してもいいですか」のフープがない

List-Unsubscribeヘッダ:

List-Unsubscribe: <mailto:unsubscribe@example.com>,
  <https://example.com/unsubscribe?token=xxx>
List-Unsubscribe-Post: List-Unsubscribe=One-Click

プリファレンスセンター:

完全にアンサブスクライブする代わりに頻度を減らすオプション


### プレーンテキスト代替案なしでHTMLを送信

重大度: 中

状況: 一部のユーザーには空白のメールが表示されます。スパムフィルターがメールをフラグ付けしています。スクリーンリーダーのアクセシビリティの問題。HTMLを削除するメールクライアントには何も表示されません。

症状:
- メールにtext/plainパートがない
- 一部のユーザーには空白のメール
- セグメント別の低いエンゲージメント

これが壊れる理由:
誰もがHTMLをレンダリングできるわけではありません。スクリーンリーダーはプレーンテキストでより良く機能します。スパムフィルターはHTMLのみを疑います。マルチパートは標準です。

推奨される修正:

```typescript
# 常にマルチパートを送信:
await resend.emails.send({
  from: 'you@example.com',
  to: 'user@example.com',
  subject: 'Welcome!',
  html: '<h1>Welcome!</h1><p>Thanks for signing up.</p>',
  text: 'Welcome!\n\nThanks for signing up.',
});

# HTMLからテキストを自動生成:
html-to-text ライブラリをフォールバックとして使用
しかし手作成のプレーンテキストが良い

# プレーンテキストは読みやすい必要があります:
タグを削除したHTMLではない
実際のフォーマット済みテキストコンテンツ

新しいIPからすぐに大量の送信

重大度: 高

状況: プロバイダを切り替えたばかり。すぐに1日50,000メール送信を開始しました。大量のデリバラビリティの問題。新しいIPには評判がありません。スパムのように見えます。

症状:

新しいIP/プロバイダ
すぐに大量の送信
突然のデリバラビリティ低下

これが壊れる理由: 新しいIPには評判がありません。すぐに大量の送信は、スピンアップしたばかりのスパマーのように見えます。徐々に信頼を構築する必要があります。

推奨される修正:

# IP ウォームアップスケジュール:

週1: 1日50〜100メール
週2: 1日200〜500メール
週3: 1日500〜1000メール
週4: 1日1000〜5000メール
ボリュームに達するまで倍増し続ける

# ベストプラクティス:
- 最も関与しているユーザーから開始
- Gmail/Microsoftに最初に送信（評判を設定）
- 一貫したボリュームを維持
- スパイクとドロップをしない

# ウォームアップ中:
- デリバラビリティを密接に監視
- フィードバックループを確認
- 問題が発生した場合は速度を調整

オプトインしなかった人にメール送信

重大度: 重大

状況: メールリストを購入しました。LinkedInからメールをスクレイプしました。カンファレンスコンタクトを追加しました。スパム苦情が増加しています。プロバイダがアカウントを一時停止します。多分訴訟があります。

症状:

メールリストを購入
スクレイプされたコンタクト
最初の送信でのアンサブスクライブレートが高い
スパム苦情が0.1%以上

これが壊れる理由: パーミッションベースのメールはオプションではありません。法律です（CAN-SPAM、GDPR）。また効果的です。不本意な受信者は、彼らが役に立つより以上に、あなたのメトリクスと評判に傷をつけます。

推奨される修正:

# パーミッション要件:

### 明示的なオプトイン:
- ユーザーはアクティブにメール受け取りを選択
- 事前にチェックされたボックスではない
- 何にサインアップしているかが明確

### ダブルオプトイン:
- リンク付きの確認メール
- 確認後のみリストに追加
- マーケティングリストのベストプラクティス

### あなたができないこと:
- メールリストを購入
- ウェブサイトからメールをスクレイプ
- 同意なしにカンファレンスコンタクトを追加
- 同意なしにパートナー/カスタマーリストを使用

### トランザクショナル例外:
パスワードリセット、領収書、アカウントアラート
マーケティングオプトインは不要

ほぼ完全にまたはまったく画像のメール

重大度: 中

状況: 美しくデザインされたメールで1つの大きな画像です。画像をブロックしたユーザーには何も見えません。スパムフィルターがフラグを立てます。モバイルロードが遅いです。誰もテキストをコピーできません。

症状:

単一の画像メール
テキストコンテンツが見えない
欠落または汎用のalt属性
画像がブロックされた場合のエンゲージメント低い

これが壊れる理由: 画像はデフォルトで多くのクライアントでブロックされます。スパムフィルターは画像のみのメールを疑います。アクセシビリティが低下します。ロード時間が増加します。

推奨される修正:

# イメージとテキストのバランス:

## 60/40ルール:
- 最低60%のテキストコンテンツ
- 拡張用のイメージ、コンテンツではない

### 常に含める:
- すべての画像のAlt テキスト
- テキストのキーメッセージ、画像だけではない
- 画像オフビュー用のフォールバック

### テスト:
- 画像を無効化して表示
- 使用可能である必要があります

# 例:
```html
<img
  src="hero.jpg"
  alt="Save 50% this week - use code SAVE50"
  style="max-width: 100%"
/>
<p>Use code <strong>SAVE50</strong> to save 50% this week.</p>


### プレビューテキストがない、またはデフォルト

重大度: 中

状況: 受信トレイに「ブラウザでこのメールを表示」またはランダムHTMLがプレビューとして表示されます。オープンレートが低いです。最初の印象が定型文で無駄になっています。

症状:
- ブラウザで表示をプレビュー
- プレビューに見えるHTMLコード
- テンプレートにプレビューコンポーネントがない

これが壊れる理由:
プレビューテキストは主要な不動産です。件名行の直後に表示されます。デフォルトまたは欠落したプレビューテキストはこのスペースを無駄にします。良いプレビューテキストはオープンレートを10〜30%増加させます。

推奨される修正:

明示的なプレビューテキストを追加:

HTMLで:

<div style="display:none;max-height:0;overflow:hidden;">
  Your preview text here. This appears in inbox preview.
  <!-- フッターテキストをプッシュアウトするためにホワイトスペースを追加 -->
  &nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;
</div>

React Emailで:

<Preview>
  Your preview text here. This appears in inbox preview.
</Preview>

ベストプラクティス:

件名行を補完
40〜100文字が最適
好奇心または価値を作成
メールの最初の行とは異なる


### 部分送信失敗を処理しない

重大度: 高

状況: 10,000ユーザーに送信しています。APIが3,000で失敗します。何が送信されたかの追跡がありません。二重送信するか7,000を失うか。誰がメールを受け取ったかを知る方法がありません。

症状:
- 受信者ごとの送信ロギングなし
- 誰がメールを受け取ったかは言えない
- 二重送信の問題
- 再試行メカニズムなし

これが壊れる理由:
一括送信は部分的に失敗します。APIタイムアウト。レート制限がヒット。個別の送信ステータスを追跡しないと、優雅に復旧することはできません。

推奨される修正:

```typescript
# 各送信を個別に追跡:

async function sendCampaign(emails: string[]) {
  const results = await Promise.allSettled(
    emails.map(async (email) => {
      try {
        const result = await resend.emails.send({ to: email, ... });
        await db.emailLog.create({
          email,
          status: 'sent',
          messageId: result.id,
        });
        return result;
      } catch (error) {
        await db.emailLog.create({
          email,
          status: 'failed',
          error: error.message,
        });
        throw error;
      }
    })
  );

  const failed = results.filter(r => r.status === 'rejected');
  // 失敗した送信を再試行するか、アラート
}

# ベストプラクティス:
- すべての送信試行をログ
- メッセージIDを追跡に含める
- 失敗用の再試行キューを構築
- キャンペーンごとの成功率を監視

検証チェック

プレーンテキストメールパートがない

重大度: 警告

メールには常にプレーンテキスト代替案が含まれるべきです

メッセージ: HTMLで送信されているメールですがプレーンテキストパートがありません。アクセシビリティとデリバラビリティのために'text:'プロパティを追加してください。

ハードコードされたfromメールアドレス

重大度: 警告

Fromアドレスは環境変数から取得する必要があります

メッセージ: Fromメールがハードコードされているようです。柔軟性のために環境変数を使用してください。

バウンスWebhookハンドラーがない

重大度: 警告

メールバウンスはリスト衛生を維持するために処理する必要があります

メッセージ: メールプロバイダが使用されていますがバウンス処理が検出されません。バウンス用のWebhookハンドラを実装してください。

List-Unsubscribeヘッダーがない

重大度: 情報

マーケティングメールにはList-Unsubscribeヘッダを含める必要があります

メッセージ: List-Unsubscribeヘッダーなしでマーケティングメールが検出されました。デリバラビリティを向上させるためにヘッダーを追加してください。

リクエストハンドラーでの同期メール送信

重大度: 警告

メール送信はキューに入れる必要があり、ブロッキングしてはいけません

メッセージ: メールがリクエストハンドラーで同期的に送信されています。信頼性を向上させるためにキューイングを検討してください。

再試行ロジックなしでのメール送信

重大度: 情報

メール送信は失敗時に再試行メカニズムを持つべきです

メッセージ: 明らかな再試行ロジックなしでメールが送信されています。一時的な失敗に対して再試行を追加してください。

コード内のメールAPI キー

重大度: エラー

APIキーは環境変数から取得する必要があります

メッセージ: メールAPI キーがソースコード内にハードコードされているようです。環境変数を使用してください。

速度制限なしの一括メール

重大度: 警告

一括送信はプロバイダーのレート制限を尊重する必要があります

メッセージ: 明らかな速度制限なしで一括メール送信しています。制限に達するのを避けるためにスロットルを追加してください。

プレビューテキストなしのメール

重大度: 情報

メールにはプレビュー/プリヘッダーテキストを含める必要があります

メッセージ: プレビューテキストなしのメールテンプレート。受信トレイプレビュー用に隠されたプリヘッダーを追加してください。

ロギングなしでのメール送信

重大度: 警告

メール送信はデバッグと監査のためにログに記録する必要があります

メッセージ: 明らかなロギングなしでメールが送信されています。デバッグとコンプライアンスのために送信をログに記録してください。

協力

委任トリガー

copy|subject|messaging|content -> copywriting（メールはコピーが必要）
design|template|visual|layout -> ui-design（メールはデザインが必要）
track|analytics|measure|metrics -> analytics-architecture（メールは追跡が必要）
infrastructure|deploy|server|queue -> devops（メールはインフラストラクチャが必要）

メールマーケティングスタック

スキル: email-systems, copywriting, marketing, analytics-architecture

ワークフロー:

1. インフラストラクチャセットアップ（email-systems）
2. テンプレート作成（email-systems）
3. コピーライティング（copywriting）
4. キャンペーン開始（marketing）
5. パフォーマンス追跡（analytics-architecture）

トランザクショナルメール

スキル: email-systems, backend, devops

ワークフロー:

1. プロバイダセットアップ（email-systems）
2. テンプレートコーディング（email-systems）
3. キュー統合（backend）
4. 監視（devops）

使用する場合

上記で説明した能力とパターンと要求が明確に一致する場合は、このスキルを使用してください。

制限

上記で説明したスコープと明確に一致する場合にのみこのスキルを使用してください。
出力を環境固有の検証、テスト、または専門家の確認の代替として扱わないでください。
必要な入力、パーミッション、セーフティ境界、または成功基準が不明な場合は、停止して説明を求めてください。

ライセンス: MIT(寛容ライセンスのため全文を引用しています) · 原本リポジトリ

詳細情報

作者: sickn33
リポジトリ: sickn33/antigravity-awesome-skills
ライセンス: MIT
最終更新: 不明

GitHubで原本を見る →フィードバックを送る

Source: https://github.com/sickn33/antigravity-awesome-skills / ライセンス: MIT

SKILL.md 本文

メールシステム

原則

パターン

トランザクショナルメールキュー

メールイベント追跡

テンプレートバージョニング

バウンス処理ステートマシン

React メールコンポーネント

プリファレンスセンター

危険な部分

SPF、DKIM、またはDMARCレコードがない

トランザクショナルメール用の共有IP

バウンス通知を処理しない

監視:

アンサブスクライブ要件:

表示:

ワンクリック:

List-Unsubscribeヘッダ:

プリファレンスセンター:

新しいIPからすぐに大量の送信

オプトインしなかった人にメール送信

ほぼ完全にまたはまったく画像のメール

明示的なプレビューテキストを追加:

HTMLで:

React Emailで:

ベストプラクティス:

検証チェック

プレーンテキストメールパートがない

ハードコードされたfromメールアドレス

バウンスWebhookハンドラーがない

List-Unsubscribeヘッダーがない

リクエストハンドラーでの同期メール送信

再試行ロジックなしでのメール送信

コード内のメールAPI キー

速度制限なしの一括メール

プレビューテキストなしのメール

ロギングなしでのメール送信

協力

委任トリガー

メールマーケティングスタック

トランザクショナルメール

使用する場合

制限

詳細情報

関連スキル

seo-maps

seo-content-brief

rakuten-seo

amazon-seo-jp

rakuten-bulk-control-csv

amazon-a-plus-content-brief