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
できること
- 必要なレイアウトに合うコンポーネント資料を選びます。
- 再利用属性とアクセシブルなラベルを使ってMJMLを作ります。
- 厳格検証と圧縮を有効にしてコンパイルし、出力を確認します。
得られるもの
- 編集可能な.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 以降)。 |
これらの手順の出典
2026-11-14 に各ベンダーのドキュメントと照合しました:
コンパイルは確認の一つ
実際の出力、サイズ、include内容、代替スタイルを確認します。圧縮だけでGmailの切り詰め上限未満になる保証はありません。
受信者が使う実際のメールクライアントでの表示テストは、公開前に別途必要です。
email-html-mjml に関するよくある質問
メールを送信しますか?
いいえ。ソースとHTMLの作成用で、配信やキャンペーンサービスは別です。
両ファイルを残す理由は?
MJMLは編集用、コンパイル後のHTMLは配信サービスに渡す成果物です。
厳格モードでinclude欠落を検出できますか?
必ずではありません。無効または拒否されたincludeが、エラー終了せず消える場合があると出典は注意しています。
Claude.aiやAPIで動きますか?
ソースの作成はできますが、そのサンドボックス内でのNodeコンパイル全工程はここでは未検証です。
ほかの AI スキル
関連スキル
copywriting スキル
コミュニティ · Corey Haines実際の利用者、根拠、範囲に基づきページ文案を作ります。アクセシビリティ修正 スキル
コミュニティ · ibelick名称、キーボード、フォーカス、意味論、通知を小さな対象修正で確認します。サムネイル設計 スキル
コミュニティ · Frank Heijdenrijk内容に忠実でスマートフォンでも読める動画サムネイルを企画し、公式機能で比較テストを計画します。デザインとテンプレート スキル
コミュニティ · Frank Heijdenrijk繰り返し使うSNS画像向けに、ブランドキット、テンプレート群、制作手順を定義します。引用カードと文字グラフィック スキル
コミュニティ · Frank Heijdenrijk根拠と出典がある一文を選び、架空の引用を作らず読みやすい文字カードを企画します。Pinterest ピン設計 スキル
コミュニティ · Frank Heijdenrijk実際のリンク先に合う、読みやすいキーワード付きの縦型Pinterest画像と異なる案を企画します。