Email HTML con MJML skill
Crea sorgente MJML e HTML compilato con validazione rigorosa e verifiche specifiche per client.
Community · Framix| Autore | Framix |
|---|---|
| Licenza | MIT |
| Fonte | framix-team/skill-email-html-mjml · SKILL.md su GitHub |
| Sito del progetto | documentation.mjml.io |
| Funziona in | Claude 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
Cosa fa
- Seleziona riferimenti dei componenti per il layout richiesto.
- Genera MJML con attributi riutilizzabili ed etichette accessibili.
- 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 cartella | A cosa serve |
|---|---|
SKILL.md | Regole di layout, accessibilità e compatibilità email. |
compilation.md | Compilazione 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/| Agente | Cartella del progetto | La tua cartella utente | Note |
|---|---|---|---|
| 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). |
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
copywriting skill
Community · Corey HainesScrivi pagine con pubblico, prove e ambito reali.Correggere l’accessibilità skill
Community · ibelickRivedi nomi, tastiera, focus, semantica e annunci con piccole modifiche mirate.Design miniature skill
Community · Frank HeijdenrijkPianifica miniature video sincere e leggibili su mobile, con test comparativo nativo.Design e modelli skill
Community · Frank HeijdenrijkDefinisci kit di marca riutilizzabile, famiglia di modelli e produzione grafica social ricorrente.Schede di citazioni e grafica testuale skill
Community · Frank HeijdenrijkScegli una frase forte con attribuzione e progetta una carta tipografica leggibile senza inventare citazioni.Design pin Pinterest skill
Community · Frank HeijdenrijkProgetta pin Pinterest verticali con parole chiave leggibili e varianti distinte per una destinazione reale.