email-write

メール作成サブスキル

目的

実績のあるコピーライティングのフレームワークを使って、プロフェッショナルでコンバージョン率の高いメール文面を作成します。スコア付きの件名案、ダークモードに対応したレスポンシブHTMLテンプレート、プレーンテキスト版のフォールバック、プリヘッダーの推奨案を生成します。

起動条件

ユーザーが新しいメールの作成を必要とする場合、メインの /email スキルからこのサブスキルが呼び出されます。

ワークフロー

1. コンテキストを収集する

まず、プロジェクトディレクトリに email-profile.md があるか確認します。存在する場合は、プロフィールからビジネスタイプ、トーンの好み、ターゲットオーディエンスを読み込みます。

プロフィールがない場合、またはユーザーが新しいコンテキストを提供する場合は、以下を尋ねます。

• メールの目的：コールドアウトリーチ、ニュースレター、製品ローンチ、プロモーション、再エンゲージメント、ウェルカムメール、機能のお知らせなど
• 受信者：名前、役職、関係性（新規見込み客、既存顧客、購読者、チームメンバー）
• トーン：プロフェッショナル、親しみやすい、カジュアル、権威のある、共感的、熱意のある
• ビジネスタイプ：（プロフィールから確認するか、質問する）SaaS、Eコマース、サービス業、エージェンシー、クリエイター、B2B、B2C
• 重要なメッセージ：受信者にどのような行動を取ってほしいですか？
• 追加のコンテキスト：製品の詳細、プロモーションの詳細、期限、パーソナライズ用データ

2. コピーのフレームワークを選ぶ

メールの目的に応じて、references/copy-frameworks.md から適切なフレームワークを選びます。

メールの目的	推奨フレームワーク	理由
コールドアウトリーチ	PAS	共感を重視し、課題に対処します
製品ローンチ	AIDA	期待感を高め、行動を促します
ニュースレター	BABまたはAIDA	期待を抱かせる、または引き込むストーリーテリング
機能のお知らせ	FAB	機能の価値提案を明確にします
プロモーション／セール	AIDA	欲求と緊急性を生み出します
再エンゲージメント	PAS	エンゲージメントの低下という課題を特定します
ウェルカムメール	BAB	変化の道のりを示します
導入事例	4Ps	根拠を重視し、推薦文を中心に構成します
レビュー依頼	PAS	共感を示しながらフィードバックを求めます
予約リマインダー	Direct	フレームワークは不要です

判断に迷う場合は、マーケティングメールには AIDA、関係構築を目的としたメールには PAS を標準として使用します。

3. 件名を生成する

以下の戦略を使って、3つの件名案を作成します。

1. 好奇心を引く：興味をかき立て、未完の問い、質問、予告を作ります
2. メリットを伝える：明確な価値提案、成果、結果を示します
3. 緊急性を伝える：時間制限、希少性、FOMOを活用します（ただし、迷惑メールのようにしません）

件名のルール：

• 最適な長さ：6～10語／30～50文字
• すべて大文字にはしないでください
• 件名あたりの感嘆符は最大1つです
• 迷惑メールと判定されやすい表現を避けます：「FREE!!!」、「Act Now」、「Limited Time Only」、「Guaranteed」、「Cash」、「No obligation」
• 可能な限りパーソナライズを含めます（名だけでなく、行動、所在地、購入履歴など）
• 強い訴求力のある語句を使います：exclusive、secret、insider、proven、breakthrough、transform、discover

スコアの算出方法（0～100）：

基準	重み	スコア
長さ	20	30～50文字なら100点、超過または不足5文字ごとに-10点
強い訴求力のある語句	20	1語につき+20点（最大2語）
パーソナライズ	25	名以外の情報でパーソナライズされていれば+25点
迷惑メールと判定されやすい表現	-50	迷惑メール用語が含まれている場合は-50点
明確さ	20	メリットまたはトピックが明確なら100点
好奇心	15	未完の問いを作っていれば+15点

合格最低スコア：70点

4. プリヘッダーテキストを書く

プリヘッダーの推奨案（30～80文字）を作成します。

• 件名を補完する内容にします（繰り返さないでください）
• 副次的な価値提案、またはCTAのプレビューを含めます
• 「このメールをブラウザーで表示」のような汎用的な文言は避けます

例：

• 件名：「パーソナライズされたSEOロードマップが完成しました」
• プリヘッダー：「今週のランキングを上げる3つの簡単な方法」

5. メール本文を作成する

選択したフレームワークの構成を適用します。執筆前に references/copy-frameworks.md からフレームワークの詳細をすべて読み込みます。

メール作成の一般ルール：

• 書き出し：最初の文で読者の関心を引き、名前が分かる場合は宛名に名前を使います
• 本文：段落は短く（最大2～3文）、読みやすさのために箇条書きを使います
• トーン：プロフィールまたはユーザー入力で指定されたトーンに合わせます
• パーソナライズ：{{firstName}}、{{company}}、{{productName}} などの差し込みタグを使います
• CTA：主要なCTAを1つ設け、明確で行動を促す表現にします（「無料監査を受ける」「今すぐ枠を確保する」「トライアルを開始する」）
• ソーシャルプルーフ：利用可能な場合は含めます（推薦文、統計、導入事例の成果）
• 署名：名前、役職、会社名を含む、ビジネスにふさわしい結びの言葉を添えます

フレームワーク別の構成：

references/copy-frameworks.md から構成全体を読み込み、適用します。各フレームワークには以下が含まれます。

• セクションの構成（例：PAS：問題 → 深刻化 → 解決）
• つなぎのフレーズ
• テンプレート例

6. HTML 版を生成する

次の仕様に従い、レスポンシブでダークモードに対応した HTML メールを作成します。

HTML テンプレートの構成：

<!DOCTYPE html>
<html lang="en">
<head>
  <meta charset="UTF-8">
  <meta name="viewport" content="width=device-width, initial-scale=1.0">
  <meta name="color-scheme" content="light dark">
  <meta name="supported-color-schemes" content="light dark">
  <title>{{emailSubject}}</title>
  <style>
    /* Inline critical CSS */
    body { margin: 0; padding: 0; font-family: Arial, Helvetica, sans-serif; }
    table { border-collapse: collapse; }
    .email-container { max-width: 600px; margin: 0 auto; }
    .body-text { font-size: 16px; line-height: 1.6; color: #333333; }
    .cta-button {
      display: inline-block;
      padding: 14px 28px;
      background-color: #0066cc;
      color: #ffffff;
      text-decoration: none;
      border-radius: 4px;
      font-weight: bold;
      min-height: 44px;
      min-width: 44px;
    }

    /* Dark mode styles */
    @media (prefers-color-scheme: dark) {
      body { background-color: #1a1a1a !important; }
      .body-text { color: #e0e0e0 !important; }
      .email-container { background-color: #2a2a2a !important; }
    }

    /* Mobile responsive */
    @media only screen and (max-width: 600px) {
      .body-text { font-size: 14px !important; }
      .headline { font-size: 22px !important; }
      .cta-button { display: block !important; width: 100% !important; }
    }
  </style>
</head>
<body>
  
</body>
</html>

HTML のルール：

• メールクライアントとの互換性のため、テーブルベースのレイアウトを使います（CSS Grid／Flexbox は使いません）
• 最大幅：600px
• 重要な CSS はインラインで記述します（クライアントによっては <style> タグが削除されるため）
• フォールバック付きのウェブセーフフォントを使います：Arial、Helvetica、Georgia、Times New Roman
• 本文の最小フォントサイズは14px、モバイルでの見出しは22px
• CTA ボタン：タップ領域を最小44x44pxにし、十分なコントラスト比（4.5:1）を確保します
• color-scheme: light dark メタタグを含めます
• @media (prefers-color-scheme: dark) を使ってダークモード用 CSS を指定します
• すべての画像に代替テキストを付けます（「画像」や「写真」ではなく、内容を説明します）
• アクセシビリティのため、プレーンテキストの MIME パートを必ず含めます

CTA ボタンのベストプラクティス：

• メールごとに主要な CTA を1つ設けます（副次的な CTA はテキストリンクでもかまいません）
• アクセシビリティのため、role="button" を指定した <a> タグを使います
• パディング：縦14px、横28px以上
• テキストとのコントラスト比が4.5:1になる背景色を使います
• ダークモード用のフォールバック（明るい背景色または反転色）を用意します

7. プレーンテキスト版を生成する

次の条件を満たすプレーンテキストのフォールバックを作成します。

• HTML タグを使わない
• 読みやすいように改行を入れます（1行最大70文字）
• CTA は完全な URL を独立した行に記載します
• 連絡先情報を含む署名ブロックを設けます

8. 出力形式

最終的なメールを次の構成で提示します。

## Email Composition

**Framework**: [chosen framework name]
**Purpose**: [email purpose]
**Tone**: [tone]
**Recipient Type**: [recipient type]

---

### Subject Line Options

| # | Subject | Score | Type | Notes |
|---|---------|-------|------|-------|
| 1 | [subject line 1] | 87 | Curiosity | [why this works] |
| 2 | [subject line 2] | 82 | Benefit | [why this works] |
| 3 | [subject line 3] | 79 | Urgency | [why this works] |

**Recommended**: #1 (highest score)

**Preheader Text**: [30-80 char preheader recommendation]

---

### Email Body (Plain Text)

[Full email body using framework structure]

[Include merge tags like {{firstName}}, {{company}}]

[CTA]

[Signature]

---

### HTML Version

```html
[Complete HTML email code with inline CSS, dark mode support, responsive design]

---

プレーンテキスト版

[Plain text fallback with line breaks, CTA as full URL]

---

メールのメタデータ

• 単語数：［本文の単語数］
• 読了時間：［推定読了時間］
• 文字数（スペースを含む）：［文字数］
• CTA 数：［CTA の数］

---

次のステップ

• コピーを確認して編集する
• 件名のバリエーションを選ぶ
• メールクライアントのプレビュー機能で HTML の表示をテストする
• MCP 経由で下書きとして送信する（利用可能な場合）。またはメール配信プラットフォームにコピーする
• 大規模なリストに送信する場合は、件名の A/B テストを行う

## Quality Gates

Before delivering the email, verify:

1. **Subject line scores**: At least one variant scores 70+
2. **Preheader length**: 30-80 characters
3. **Framework alignment**: Body follows chosen framework structure
4. **CTA clarity**: Primary CTA is clear and action-oriented
5. **Mobile readability**: Paragraphs are 2-3 sentences max
6. **HTML validity**: Table-based layout, inline CSS, dark mode support
7. **Accessibility**: Alt text on images, plain-text fallback included
8. **Spam check**: No spam trigger words in subject or body
9. **Personalization**: Merge tags used where appropriate
10. **Tone match**: Email tone matches requested tone from profile

If any gate fails, revise before output.

## Error Handling

- If `references/copy-frameworks.md` is missing, warn user and use basic AIDA structure
- If `email-profile.md` is missing, prompt user for context (don't fail)
- If subject line scores are all below 70, generate new variants
- If HTML template fails validation, fall back to plain-text only and warn user

## Resources

- `references/copy-frameworks.md` - Full framework structures and examples
- `email-profile.md` - User's business context and preferences (optional)

## Example Invocation

User: "Write a cold outreach email to a SaaS founder about my SEO audit service"

Agent:
1. Loads email-profile.md (if exists)
2. Selects PAS framework (cold outreach)
3. Generates 3 subject line variants with scores
4. Writes email body following PAS structure
5. Creates HTML template with dark mode
6. Creates plain-text fallback
7. Outputs full email composition with metadata and next steps

## Notes

- This sub-skill focuses on composition only (no sending/scheduling)
- For sending emails, use `email-send` sub-skill or MCP email tools
- For A/B testing, generate multiple variants using different frameworks
- Always adapt tone and complexity to recipient type (B2B vs B2C, technical vs non-technical)