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 截断、无障碍内容和安全的模板引用。编译成功不等于所有邮件客户端都能正确显示。
摘自该技能的 SKILL.md: # email-html-mjml — Responsive Email Developer
功能
- 为所需邮件布局选择组件参考资料。
- 生成带复用属性和无障碍标签的 MJML。
- 以严格校验与压缩选项编译,再检查输出。
产出内容
- 可编辑的 .mjml 源码和编译后的 .html。
- 客户端兼容性与编译说明。
适用场景
- 制作事务邮件、新闻邮件和促销模板。
- 排查引用内容丢失或 Outlook 背景回退问题。
不适用的场景
- 发送营销活动,或在未运行测试时宣称已完成真实客户端测试。
所需条件
- Node.js 20 或更新版本,以及项目本地安装的 MJML 5.x。
- 邮件测试服务可选且可能收费;生成文件不需要邮件发送账号。
技能包含的文件
| 文件或文件夹 | 用途 |
|---|---|
SKILL.md | 邮件布局、无障碍与兼容性规则。 |
compilation.md | 严格编译与引用验证。 |
components/ | MJML 组件参考。 |
assets/examples/ | 新闻邮件、订单与促销示例。 |
2026-11-17 在仓库中查到的许可证:MIT。
示例提示词
安装后输入下面任意一条;在提示词中点名技能,可确保它被使用。
- 制作无障碍订单确认邮件,交付 MJML 与严格编译后的 HTML。
- 排查为什么 MJML 成功退出后页脚引用仍然丢失。
- 为这封新闻邮件添加 Outlook 回退字体与背景色。
如何安装 email-html-mjml
编译器与引用
在目标项目安装 MJML 并固定兼容版本。技能文件夹本身不会安装编译器。
MJML 5 默认禁用引用。请明确启用、设置允许目录,再检查编译结果是否含有预期内容。
技能(Skill)是一个包含 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 文件夹。四者在项目中都认可的文件夹是 .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 安装。2026 年 6 月 18 日起,Google 已用 Antigravity CLI 取代 Gemini CLI,面向免费层级和 Google One 用户;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 对照各厂商的文档核实:
编译只是其中一项检查
请检查实际输出、文件大小、引用内容和回退样式。压缩不能保证邮件低于 Gmail 截断阈值。
在收件人使用的真实邮件客户端中进行渲染测试,仍是单独的发布检查。
关于 email-html-mjml 的常见问题
它会发送邮件吗?
不会。它生成源码和 HTML,邮件投递与营销平台是另外的环节。
为什么保留两种文件?
MJML 用于后续编辑,编译后的 HTML 用于提交给邮件发送服务。
严格模式会发现引用缺失吗?
不一定。源码提醒:被禁用或拒绝的引用可能被移除,但退出码仍表示成功。
可以在 Claude.ai 或 API 中运行吗?
可以起草源码,但这里未验证完整 Node 编译流程能在这些沙箱环境运行。
更多 AI 技能
相关技能
copywriting 技能
社区 · Corey Haines用真实受众、证据和明确范围起草或修改页面文案。无障碍修复技能
社区 · ibelick用小范围修正审查名称、键盘操作、焦点、语义与状态播报。缩略图设计 技能
社区 · Frank Heijdenrijk规划真实、适合手机阅读的视频缩略图简报,并设计原生对比测试。设计与模板 技能
社区 · Frank Heijdenrijk为周期性社交图形制定可复用品牌套件、模板系列及制作流程。引用卡片与文字图形 技能
社区 · Frank Heijdenrijk选择一句有力原文并正确署名,规划易读文字卡片,不编造引文。Pinterest 图钉设计 技能
社区 · Frank Heijdenrijk规划竖版 Pinterest 图钉概念,搭配易读关键词叠字及针对真实目标页的不同方案。