E-mail HTML com MJML skill
Crie código MJML e HTML compilado com validação estrita e verificações específicas por cliente.
Comunidade · Framix| Autor | Framix |
|---|---|
| Licença | MIT |
| Fonte | framix-team/skill-email-html-mjml · SKILL.md no GitHub |
| Site do projeto | documentation.mjml.io |
| Funciona em | Claude Code · Codex, Gemini CLI, Cursor, Copilot |
| Lido na fonte em |
email-html-mjml cria modelos de email responsivos com MJML 5.x e entrega o código MJML e o HTML compilado.
As referências cobrem alternativas para Outlook, corte no Gmail, conteúdo acessível e inclusões seguras. Compilar com sucesso não prova renderização em todo cliente de email.
Do SKILL.md da skill: # email-html-mjml — Responsive Email Developer
O que ela faz
- Selecione referências de componentes para o layout solicitado.
- Gere MJML com atributos reutilizáveis e rótulos acessíveis.
- Compile com validação estrita e minificação; examine a saída.
O que você recebe
- Código .mjml editável e .html compilado.
- Notas de compatibilidade com clientes e compilação.
Quando usar
- Criar emails transacionais, newsletters e modelos promocionais.
- Depurar inclusões ausentes ou alternativas de fundo para Outlook.
Quando não usar
- Enviar campanhas ou alegar testes reais em clientes sem realizá-los.
O que ela exige
- Node.js 20 ou posterior e instalação de MJML 5.x no projeto.
- Um serviço de testes de email é opcional e pode ser pago; gerar arquivos não exige conta de envio.
Arquivos da skill
| Arquivo ou pasta | Para que serve |
|---|---|
SKILL.md | Regras de layout, acessibilidade e compatibilidade de email. |
compilation.md | Compilação estrita e verificação de inclusões. |
components/ | Referências de componentes MJML. |
assets/examples/ | Exemplos de newsletter, pedidos e promoções. |
Licença conforme encontrada no repositório em 2026-11-17: MIT.
Prompts de exemplo
Digite um destes depois de instalar; citar a skill pelo nome garante que ela seja usada.
- Crie um email acessível de confirmação de pedido e entregue MJML e HTML compilado estritamente.
- Descubra por que a inclusão do rodapé sumiu mesmo com a saída bem-sucedida do MJML.
- Adapte esta newsletter ao Outlook com fonte alternativa e cor de fundo.
Como instalar a skill email-html-mjml
Compilador e inclusões
Instale MJML no projeto de destino e fixe uma versão compatível. A pasta da skill não instala o compilador.
Inclusões no MJML 5 ficam desativadas por padrão. Ative e permita explicitamente; confira o conteúdo esperado no HTML compilado.
Uma skill é uma pasta com um arquivo SKILL.md. Você instala uma vez; o agente lê a descrição curta no início de cada sessão e só carrega as instruções completas quando um pedido corresponde a ela. Escolha onde você usa:
Claude Code: copie a pasta para a sua pasta de skills
Coloque a pasta da skill em ~/.claude/skills/ para usá-la em todos os projetos deste computador, ou em .claude/skills/ dentro de um repositório para compartilhá-la com todos que trabalham nele (faça o commit).
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/O Claude Code percebe skills novas ou alteradas nessas pastas durante a sessão. Se a pasta de skills não existia quando a sessão começou, execute /reload-skills uma vez. Depois digite /email-html-mjml ou apenas descreva a tarefa.
No Windows, execute os comandos no Git Bash ou no WSL, ou copie a pasta para o mesmo lugar pelo Explorador de Arquivos.
Codex, Gemini CLI, Cursor e GitHub Copilot
Esses agentes leem as mesmas pastas SKILL.md. A única pasta dentro de um projeto que os quatro aceitam é .agents/skills/, então este comando copia a skill para lá:
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/| Agente | Pasta do projeto | Sua pasta de usuário | Observações |
|---|---|---|---|
| OpenAI Codex | .agents/skills/ | ~/.agents/skills/ | Digite $ ou execute /skills para escolher uma skill; o Codex também escolhe uma sozinho quando a tarefa corresponde. |
| Gemini CLI | .agents/skills/.gemini/skills/ | ~/.agents/skills/~/.gemini/skills/ | Ou instale pelo Git com gemini skills install <git URL> --path <folder> --consent. Em 18 de junho de 2026, o Google substituiu o Gemini CLI pelo Antigravity CLI para usuários do nível gratuito e do Google One; o Antigravity usa .agents/skills/ no projeto e ~/.gemini/config/skills/ para você. |
| Cursor | .agents/skills/.cursor/skills/ | ~/.agents/skills/~/.cursor/skills/ | Digite / no chat do Agent para escolher uma skill. O Cursor também lê as pastas .claude/skills/ do Claude Code. |
| GitHub Copilot | .github/skills/.agents/skills/.claude/skills/ | ~/.copilot/skills/~/.agents/skills/ | Funciona no Copilot CLI, no agente na nuvem e no modo agente do VS Code, do Visual Studio e dos IDEs da JetBrains (o suporte nos IDEs depende da versão). Ou execute gh skill install OWNER/REPOSITORY SKILL (prévia pública, GitHub CLI 2.90.0 ou mais recente). |
Fontes destas instruções
Conferido com a documentação de cada fornecedor em 2026-11-14:
Compilar é apenas uma verificação
Inspecione a saída real, tamanho, conteúdo incluído e estilos alternativos. Minificar não garante ficar abaixo do limite de corte do Gmail.
Testes de renderização nos clientes usados pelos destinatários continuam sendo uma etapa separada antes da publicação.
Perguntas sobre a skill email-html-mjml
Envia emails?
Não. Gera código e HTML; entrega e plataformas de campanha são separadas.
Por que manter os dois arquivos?
MJML continua editável; o HTML compilado é o arquivo entregue ao serviço de envio.
O modo estrito detecta inclusões ausentes?
Não necessariamente. A origem alerta que inclusões desativadas ou negadas podem ser descartadas sem código de erro.
Funciona no Claude.ai ou na API?
A redação do código pode funcionar, mas o fluxo completo de compilação Node não foi verificado nesses ambientes isolados aqui.
Mais skills de IA
Skills relacionadas
copywriting skill
Comunidade · Corey HainesRedija páginas com público, provas e escopo reais.Corrigir acessibilidade skill
Comunidade · ibelickRevise nomes, teclado, foco, semântica e anúncios com alterações pequenas e direcionadas.Design de miniaturas skill
Comunidade · Frank HeijdenrijkPlaneje miniaturas de vídeo honestas e legíveis no celular, com teste comparativo nativo.Design e modelos skill
Comunidade · Frank HeijdenrijkDefina kit de marca reutilizável, família de modelos e fluxo de produção para gráficos sociais recorrentes.Cartões de citações e gráficos de texto skill
Comunidade · Frank HeijdenrijkEscolha e atribua uma frase forte e planeje um cartão tipográfico legível sem fabricar citações.Design de pins do Pinterest skill
Comunidade · Frank HeijdenrijkPlaneje conceitos Pinterest verticais com palavras-chave legíveis e variantes distintas para um destino real.