Aller au contenu

E-mail HTML avec MJML skill

Créez la source MJML et le HTML compilé avec validation stricte et contrôles propres aux clients mail.

Communauté · Framix
AuteurFramix
LicenceMIT
Sourceframix-team/skill-email-html-mjml · SKILL.md sur GitHub
Site du projetdocumentation.mjml.io
Fonctionne dansClaude Code · Codex, Gemini CLI, Cursor, Copilot
Lu à la source le

email-html-mjml construit des e-mails adaptatifs avec MJML 5.x et livre source MJML et HTML compilé.

Les références couvrent replis Outlook, troncature Gmail, accessibilité et inclusions sûres. Une compilation réussie ne prouve pas le rendu dans tous les clients.

Extrait du SKILL.md du skill : # email-html-mjml — Responsive Email Developer

Ceci est un skill de la communauté créé par Framix, vérifié ni par nous ni par Anthropic. Un skill peut demander à l’agent d’exécuter du code, de lire des fichiers ou d’accéder au réseau. Avant de l’installer, lisez son SKILL.md et chaque script du dossier, et cherchez tout ce qui ne correspond pas à ce qu’il prétend faire.

Ce qu’il fait

  1. Choisissez les références de composants pour la mise en page demandée.
  2. Générez du MJML avec attributs réutilisables et libellés accessibles.
  3. Compilez avec validation stricte et minification, puis inspectez la sortie.

Ce que vous obtenez

  • Source .mjml modifiable et fichier .html compilé.
  • Notes de compatibilité et de compilation.

Quand l’utiliser

  • Créer des e-mails transactionnels, newsletters et modèles promotionnels.
  • Diagnostiquer une inclusion manquante ou un repli de fond Outlook.

Quand ne pas l’utiliser

  • Envoyer des campagnes ou affirmer des tests clients réels non effectués.

Ce qu’il faut

  • Node.js 20 ou ultérieur et installation MJML 5.x locale au projet.
  • Un service de test mail est facultatif et peut être payant ; générer les fichiers ne nécessite pas de compte d’envoi.

Fichiers du skill

Fichier ou dossierÀ quoi il sert
SKILL.mdRègles de mise en page, accessibilité et compatibilité mail.
compilation.mdCompilation stricte et vérification des inclusions.
components/Références des composants MJML.
assets/examples/Exemples de newsletter, commande et promotion.

Licence trouvée dans le dépôt le 2026-11-17 : MIT.

Exemples de prompts

Tapez l’un de ces prompts après l’installation ; nommer le skill garantit qu’il sera utilisé.

  • Créez une confirmation de commande accessible avec MJML et HTML compilé strictement.
  • Trouvez pourquoi mon pied de page inclus manque malgré une sortie MJML réussie.
  • Adaptez cette newsletter à Outlook avec police et couleur de fond de repli.

Comment installer email-html-mjml

Compilateur et inclusions

Installez MJML dans le projet cible et fixez une version compatible. Le dossier de skill n’installe pas le compilateur.

MJML 5 désactive les inclusions par défaut. Activez-les avec une liste de dossiers autorisés, puis vérifiez le contenu attendu dans la sortie.

Un skill est un dossier contenant un fichier SKILL.md. Vous l’installez une fois ; l’agent lit sa courte description au début de chaque session et ne charge les instructions complètes que si une demande correspond. Choisissez l’environnement que vous utilisez :

Claude Code : copier le dossier dans votre dossier de skills

Placez le dossier du skill dans ~/.claude/skills/ pour l’utiliser dans tous les projets de cet ordinateur, ou dans .claude/skills/ à l’intérieur d’un dépôt pour le partager avec toutes les personnes qui y travaillent (committez-le).

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 détecte pendant la session les skills nouveaux ou modifiés dans ces dossiers. Si le dossier de skills n’existait pas au démarrage de la session, lancez /reload-skills une fois. Tapez ensuite /email-html-mjml ou décrivez simplement la tâche.

Sous Windows, lancez les commandes dans Git Bash ou WSL, ou copiez le dossier au même endroit avec l’Explorateur de fichiers.

Codex, Gemini CLI, Cursor et GitHub Copilot

Ces agents lisent les mêmes dossiers SKILL.md. Le seul dossier que les quatre acceptent dans un projet est .agents/skills/ ; cette commande y copie donc le 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/
AgentDossier du projetVotre dossier utilisateurRemarques
OpenAI Codex
.agents/skills/
~/.agents/skills/
Tapez $ ou lancez /skills pour choisir un skill ; Codex en choisit aussi un quand votre tâche correspond.
Gemini CLI
.agents/skills/
.gemini/skills/
~/.agents/skills/
~/.gemini/skills/
Ou installez-le depuis Git avec gemini skills install <git URL> --path <folder> --consent. Le 18 juin 2026, Google a remplacé Gemini CLI par Antigravity CLI pour les utilisateurs de l’offre gratuite et de Google One ; Antigravity utilise .agents/skills/ dans un projet et ~/.gemini/config/skills/ pour vous.
Cursor
.agents/skills/
.cursor/skills/
~/.agents/skills/
~/.cursor/skills/
Tapez / dans le chat Agent pour choisir un skill. Cursor lit aussi les dossiers .claude/skills/ de Claude Code.
GitHub Copilot
.github/skills/
.agents/skills/
.claude/skills/
~/.copilot/skills/
~/.agents/skills/
Fonctionne dans Copilot CLI, l’agent cloud et le mode agent de VS Code, Visual Studio et JetBrains (la prise en charge dans l’IDE dépend de la version). Ou lancez gh skill install OWNER/REPOSITORY SKILL (préversion publique, GitHub CLI 2.90.0 ou ultérieure).
N’installez que des skills de confiance. Anthropic conseille de n’utiliser que des skills provenant de sources de confiance, et de lire chaque fichier de tout autre skill avant de l’utiliser : un skill peut amener l’agent à exécuter des commandes, lire des fichiers ou envoyer des données d’une manière que sa description ne mentionne pas.

Sources de ces étapes

Vérifiées dans la documentation de chaque éditeur le 2026-11-14 :

La compilation est un contrôle

Inspectez sortie, taille, contenu inclus et styles de repli. Minifier ne garantit pas de rester sous le seuil de troncature Gmail.

Tester le rendu dans les clients des destinataires reste un contrôle de publication distinct.

Questions sur email-html-mjml

Envoie-t-il les e-mails ?

Non. Il produit source et HTML ; envoi et plateformes de campagne sont séparés.

Pourquoi garder les deux fichiers ?

MJML reste modifiable ; le HTML compilé est fourni au service d’envoi.

Le mode strict détecte-t-il les inclusions absentes ?

Pas forcément. La source prévient qu’une inclusion désactivée ou refusée peut disparaître sans code de sortie en échec.

Fonctionne-t-il dans Claude.ai ou via API ?

La rédaction de source est possible, mais la compilation Node complète n’a pas été vérifiée dans ces environnements isolés ici.

Plus de skills IA

Skills similaires

Catégories de skills