Vai al contenuto

Email HTML con MJML skill

Crea sorgente MJML e HTML compilato con validazione rigorosa e verifiche specifiche per client.

Community · Framix
AutoreFramix
LicenzaMIT
Fonteframix-team/skill-email-html-mjml · SKILL.md su GitHub
Sito del progettodocumentation.mjml.io
Funziona inClaude Code · Codex, Gemini CLI, Cursor, Copilot
Letta dalla fonte il

email-html-mjml crea modelli email responsive con MJML 5.x e consegna sorgente MJML e HTML compilato.

Le fonti coprono alternative Outlook, troncamento Gmail, contenuti accessibili e inclusioni sicure. Compilare correttamente non dimostra la resa in ogni client email.

Dallo SKILL.md della skill: # email-html-mjml — Responsive Email Developer

Questa è una skill della community di Framix, non verificata da noi né da Anthropic. Le skill possono dire all'agente di eseguire codice, leggere file o accedere alla rete. Prima di installarla, leggi il suo SKILL.md e ogni script nella cartella, e cerca qualsiasi cosa che non corrisponda a ciò che dichiara di fare.

Cosa fa

  1. Seleziona riferimenti dei componenti per il layout richiesto.
  2. Genera MJML con attributi riutilizzabili ed etichette accessibili.
  3. Compila con validazione rigorosa e minificazione, poi esamina l’uscita.

Cosa ottieni

  • Sorgente .mjml modificabile e .html compilato.
  • Note di compilazione e compatibilità con i client.

Quando usarla

  • Creare email transazionali, newsletter e modelli promozionali.
  • Individuare inclusioni mancanti o alternative di sfondo per Outlook.

Quando non usarla

  • Inviare campagne o dichiarare test su client reali senza eseguirli.

Cosa richiede

  • Node.js 20 o successivo e MJML 5.x installato nel progetto.
  • Il servizio di test email è facoltativo e può essere a pagamento; generare file non richiede account di invio.

File della skill

File o cartellaA cosa serve
SKILL.mdRegole di layout, accessibilità e compatibilità email.
compilation.mdCompilazione rigorosa e verifica delle inclusioni.
components/Riferimenti dei componenti MJML.
assets/examples/Esempi di newsletter, ordini e promozioni.

Licenza trovata nel repository il 2026-11-17: MIT.

Prompt di esempio

Scrivine uno dopo l'installazione; nominare la skill fa sì che venga usata.

  • Crea una conferma d’ordine accessibile e consegna MJML e HTML compilato rigorosamente.
  • Trova perché l’inclusione del piè di pagina è sparita nonostante MJML sia terminato senza errori.
  • Adatta questa newsletter a Outlook con carattere alternativo e colore di sfondo.

Come installare email-html-mjml

Compilatore e inclusioni

Installa MJML nel progetto e fissa una versione compatibile. La cartella della skill non installa il compilatore.

Le inclusioni MJML 5 sono disabilitate per impostazione predefinita. Abilitale e autorizzale deliberatamente, poi verifica contenuti noti nell’HTML compilato.

Una skill è una cartella con un file SKILL.md. La installi una volta sola; l'agente legge la sua breve descrizione all'inizio di ogni sessione e carica le istruzioni complete solo quando una richiesta corrisponde. Scegli dove la usi:

Claude Code: copia la cartella nella tua cartella delle skill

Metti la cartella della skill in ~/.claude/skills/ per usarla in tutti i progetti su questo computer, oppure in .claude/skills/ dentro un repository per condividerla con chiunque ci lavori (fanne il 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/

Claude Code rileva le skill nuove o modificate in queste cartelle durante la sessione. Se la cartella delle skill non esisteva quando è iniziata la sessione, esegui una volta /reload-skills. Poi digita /email-html-mjml o descrivi semplicemente il compito.

Su Windows, esegui i comandi in Git Bash o WSL, oppure copia la cartella nello stesso percorso con Esplora file.

Codex, Gemini CLI, Cursor e GitHub Copilot

Questi agenti leggono le stesse cartelle SKILL.md. L'unica cartella di progetto accettata da tutti e quattro è .agents/skills/, quindi questo comando ci copia la skill:

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/
AgenteCartella del progettoLa tua cartella utenteNote
OpenAI Codex
.agents/skills/
~/.agents/skills/
Digita $ o esegui /skills per scegliere una skill; Codex ne sceglie una anche da solo quando il tuo compito corrisponde.
Gemini CLI
.agents/skills/
.gemini/skills/
~/.agents/skills/
~/.gemini/skills/
Oppure installa da Git con gemini skills install <git URL> --path <folder> --consent. Il 18 giugno 2026 Google ha sostituito Gemini CLI con Antigravity CLI per gli utenti del piano gratuito e di Google One; Antigravity usa .agents/skills/ in un progetto e ~/.gemini/config/skills/ per te.
Cursor
.agents/skills/
.cursor/skills/
~/.agents/skills/
~/.cursor/skills/
Digita / nella chat Agent per scegliere una skill. Cursor legge anche le cartelle .claude/skills/ di Claude Code.
GitHub Copilot
.github/skills/
.agents/skills/
.claude/skills/
~/.copilot/skills/
~/.agents/skills/
Funziona in Copilot CLI, nel cloud agent e nella modalità agente di VS Code, Visual Studio e JetBrains (il supporto negli IDE dipende dalla versione). Oppure esegui gh skill install OWNER/REPOSITORY SKILL (anteprima pubblica, GitHub CLI 2.90.0 o successiva).
Installa solo skill di cui ti fidi. Anthropic consiglia di usare solo skill di fonti affidabili e di leggere ogni file di qualsiasi altra skill prima di usarla: una skill può indurre l'agente a eseguire comandi, leggere file o inviare dati in modi che la sua descrizione non menziona.

Fonti per questi passaggi

Verificati sulla documentazione di ciascun fornitore il 2026-11-14:

Compilare è solo una verifica

Esamina uscita reale, dimensione, contenuti inclusi e stili alternativi. Minificare non garantisce di restare sotto la soglia di troncamento Gmail.

I test di resa nei client dei destinatari restano una verifica separata prima della pubblicazione.

Domande su email-html-mjml

Invia email?

No. Genera sorgente e HTML; invio e piattaforme di campagna sono separati.

Perché conservare entrambi i file?

MJML resta modificabile; l’HTML compilato è il file da fornire al servizio di invio.

La modalità rigorosa rileva inclusioni mancanti?

Non necessariamente. La fonte avverte che inclusioni disabilitate o negate possono sparire senza codice di uscita di errore.

Funziona in Claude.ai o nell’API?

La stesura del sorgente può funzionare, ma il flusso Node completo non è stato verificato qui in quegli ambienti isolati.

Altre skill IA

Skill correlate

Categorie di skill