コンテンツへスキップ

MJML HTML メール スキル

厳格な検証とメールクライアント別確認で、MJMLソースとコンパイル済みHTMLを作ります。

コミュニティ · Framix
作者Framix
ライセンスMIT
ソースframix-team/skill-email-html-mjml · GitHub 上の SKILL.md
プロジェクトサイトdocumentation.mjml.io
対応環境Claude Code · Codex、Gemini CLI、Cursor、Copilot
ソースを確認した日

email-html-mjmlはMJML 5.xでレスポンシブメールを作り、MJMLソースとコンパイル済みHTMLの両方を渡します。

Outlook代替表示、Gmailの切り詰め、アクセシビリティ、安全なincludeを扱います。コンパイル成功だけでは全メールクライアントの表示を証明できません。

スキルの SKILL.md より: # email-html-mjml — Responsive Email Developer

これは Framix によるコミュニティスキルで、当サイトや Anthropic による確認は受けていません。スキルはエージェントにコードの実行、ファイルの読み取り、ネットワークへのアクセスを指示できます。インストール前に SKILL.md とフォルダー内のすべてのスクリプトを読み、説明と食い違う動作がないか確認してください。

できること

  1. 必要なレイアウトに合うコンポーネント資料を選びます。
  2. 再利用属性とアクセシブルなラベルを使ってMJMLを作ります。
  3. 厳格検証と圧縮を有効にしてコンパイルし、出力を確認します。

得られるもの

  • 編集可能な.mjmlソースとコンパイル済み.html。
  • クライアント互換性とコンパイルの説明。

使う場面

  • 取引メール、ニュースレター、販促テンプレートの作成。
  • include欠落やOutlook背景の代替表示の調査。

向かない場面

  • 配信や、実行していない実クライアント試験済みの主張。

必要なもの

  • Node.js 20以降と、プロジェクト内に導入したMJML 5.x。
  • メールテストサービスは任意で有料の場合があります。ファイル作成だけなら配信アカウントは不要です。

スキルに含まれるファイル

ファイル・フォルダー用途
SKILL.mdメール配置、アクセシビリティ、互換性の規則。
compilation.md厳格コンパイルとinclude確認。
components/MJMLコンポーネント資料。
assets/examples/ニュースレター、注文、販促のサンプル。

2026-11-17 時点でリポジトリに記載されていたライセンス:MIT。

プロンプト例

インストール後に次のいずれかを入力してください。スキル名を書くと確実にそのスキルが使われます。

  • アクセシブルな注文確認メールを作り、MJMLと厳格コンパイル済みHTMLを渡してください。
  • MJMLが正常終了したのにフッターincludeが消えた理由を調べてください。
  • このニュースレターにOutlook用の代替フォントと背景色を設定してください。

email-html-mjml のインストール方法

コンパイラーとinclude

対象プロジェクトにMJMLを導入し、互換バージョンを固定します。スキルフォルダー自体はコンパイラーを入れません。

MJML 5はincludeが初期状態で無効です。必要な範囲だけ許可し、コンパイル結果に既知の内容が入るか確認します。

スキルは SKILL.md ファイルを含むフォルダーです。インストールは一度だけで、エージェントは各セッションの開始時に短い説明を読み、リクエストが当てはまったときにだけ完全な指示を読み込みます。使う環境を選んでください:

Claude Code:スキルフォルダーにフォルダーをコピー

このパソコン上のすべてのプロジェクトで使うならスキルのフォルダーを ~/.claude/skills/ に、作業者全員で共有するならリポジトリ内の .claude/skills/ に置きます(コミットしてください)。

git clone --depth 1 https://github.com/framix-team/skill-email-html-mjml.git
mkdir -p ~/.claude/skills
cp -R skill-email-html-mjml/email-html-mjml ~/.claude/skills/

Claude Code はセッション中にこれらのフォルダーで新しいスキルや変更されたスキルを検出します。セッション開始時にスキルフォルダーが存在しなかった場合は、/reload-skills を一度実行してください。その後 /email-html-mjml と入力するか、作業内容をそのまま伝えます。

Windows では Git Bash または WSL でコマンドを実行するか、エクスプローラーで同じ場所にフォルダーをコピーしてください。

Codex、Gemini CLI、Cursor、GitHub Copilot

これらのエージェントも同じ SKILL.md フォルダーを読みます。4 つすべてがプロジェクト内で読むフォルダーは .agents/skills/ なので、次のコマンドでスキルをそこにコピーします:

git clone --depth 1 https://github.com/framix-team/skill-email-html-mjml.git
mkdir -p .agents/skills
cp -R skill-email-html-mjml/email-html-mjml .agents/skills/
エージェントプロジェクトのフォルダーユーザーのフォルダーメモ
OpenAI Codex
.agents/skills/
~/.agents/skills/
$ と入力するか /skills を実行してスキルを選びます。タスクが当てはまれば Codex が自動で選ぶこともあります。
Gemini CLI
.agents/skills/
.gemini/skills/
~/.agents/skills/
~/.gemini/skills/
または gemini skills install <git URL> --path <folder> --consent で Git からインストールします。Google は 2026 年 6 月 18 日、無料枠と Google One のユーザー向けに Gemini CLI を Antigravity CLI に置き換えました。Antigravity はプロジェクトでは .agents/skills/、ユーザー用には ~/.gemini/config/skills/ を使います。
Cursor
.agents/skills/
.cursor/skills/
~/.agents/skills/
~/.cursor/skills/
Agent チャットで / を入力してスキルを選びます。Cursor は Claude Code の .claude/skills/ フォルダーも読みます。
GitHub Copilot
.github/skills/
.agents/skills/
.claude/skills/
~/.copilot/skills/
~/.agents/skills/
Copilot CLI、クラウドエージェント、VS Code・Visual Studio・JetBrains のエージェントモードで動きます(IDE の対応はバージョンによります)。または gh skill install OWNER/REPOSITORY SKILL を実行します(パブリックプレビュー、GitHub CLI 2.90.0 以降)。
信頼できるスキルだけをインストールする. Anthropic は、信頼できる入手元のスキルだけを使い、それ以外のスキルは使う前にすべてのファイルを読むよう勧めています。スキルは、説明に書かれていない方法でエージェントにコマンドの実行、ファイルの読み取り、データの送信を指示できるからです。

これらの手順の出典

2026-11-14 に各ベンダーのドキュメントと照合しました:

コンパイルは確認の一つ

実際の出力、サイズ、include内容、代替スタイルを確認します。圧縮だけでGmailの切り詰め上限未満になる保証はありません。

受信者が使う実際のメールクライアントでの表示テストは、公開前に別途必要です。

email-html-mjml に関するよくある質問

メールを送信しますか?

いいえ。ソースとHTMLの作成用で、配信やキャンペーンサービスは別です。

両ファイルを残す理由は?

MJMLは編集用、コンパイル後のHTMLは配信サービスに渡す成果物です。

厳格モードでinclude欠落を検出できますか?

必ずではありません。無効または拒否されたincludeが、エラー終了せず消える場合があると出典は注意しています。

Claude.aiやAPIで動きますか?

ソースの作成はできますが、そのサンドボックス内でのNodeコンパイル全工程はここでは未検証です。

ほかの AI スキル

関連スキル

スキルのカテゴリー