Pular para o conteúdo

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
AutorFramix
LicençaMIT
Fonteframix-team/skill-email-html-mjml · SKILL.md no GitHub
Site do projetodocumentation.mjml.io
Funciona emClaude 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

Esta é uma skill da comunidade, de Framix, sem verificação nossa nem da Anthropic. Skills podem mandar o agente executar código, ler arquivos ou acessar a rede. Antes de instalar, leia o SKILL.md e todos os scripts da pasta, e procure qualquer coisa que não corresponda ao que ela diz fazer.

O que ela faz

  1. Selecione referências de componentes para o layout solicitado.
  2. Gere MJML com atributos reutilizáveis e rótulos acessíveis.
  3. 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 pastaPara que serve
SKILL.mdRegras de layout, acessibilidade e compatibilidade de email.
compilation.mdCompilaçã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/
AgentePasta do projetoSua pasta de usuárioObservaçõ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).
Instale só skills em que você confia. A recomendação da Anthropic é usar skills apenas de fontes confiáveis e ler todos os arquivos de qualquer outra skill antes de usá-la: uma skill pode mandar o agente executar comandos, ler arquivos ou enviar dados de formas que a descrição não menciona.

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

Categorias de skills