Saltar al contenido

Correo HTML con MJML skill

Crea fuente MJML y HTML compilado con validación estricta y comprobaciones específicas de clientes de correo.

Comunidad · Framix
AutorFramix
LicenciaMIT
Fuenteframix-team/skill-email-html-mjml · SKILL.md en GitHub
Sitio del proyectodocumentation.mjml.io
Funciona enClaude Code · Codex, Gemini CLI, Cursor, Copilot
Leída en la fuente el

email-html-mjml crea plantillas de correo adaptables con MJML 5.x y entrega tanto la fuente MJML como el HTML compilado.

Incluye referencias de alternativas para Outlook, recorte de Gmail, accesibilidad e inclusiones seguras. Compilar correctamente no prueba el aspecto en todos los clientes.

Del SKILL.md de la skill: # email-html-mjml — Responsive Email Developer

Esta es una skill de la comunidad creada por Framix, sin revisar por nosotros ni por Anthropic. Las skills pueden indicar al agente que ejecute código, lea archivos o acceda a la red. Antes de instalarla, lee su SKILL.md y cada script de la carpeta, y busca cualquier cosa que no encaje con lo que dice hacer.

Qué hace

  1. Selecciona referencias de componentes para el diseño solicitado.
  2. Genera MJML con atributos reutilizables y etiquetas accesibles.
  3. Compila con validación estricta y minificación; inspecciona el resultado.

Qué obtienes

  • Fuente .mjml editable y .html compilado.
  • Notas de compilación y compatibilidad con clientes.

Cuándo usarla

  • Crear mensajes transaccionales, boletines y promociones.
  • Depurar inclusiones perdidas o alternativas de fondo en Outlook.

Cuándo no usarla

  • Enviar campañas o afirmar pruebas en clientes reales sin realizarlas.

Qué necesita

  • Node.js 20 o posterior y MJML 5.x instalado en el proyecto.
  • Un servicio de pruebas de correo es opcional y puede ser de pago; generar archivos no necesita cuenta de envío.

Archivos de la skill

Archivo o carpetaPara qué sirve
SKILL.mdReglas de diseño, accesibilidad y compatibilidad de correo.
compilation.mdCompilación estricta y verificación de inclusiones.
components/Referencias de componentes MJML.
assets/examples/Ejemplos de boletines, pedidos y promociones.

Licencia según el repositorio el 2026-11-17: MIT.

Prompts de ejemplo

Escribe uno de estos después de instalarla; si nombras la skill, te aseguras de que se use.

  • Crea un correo accesible de confirmación de pedido y entrega MJML y HTML compilado con validación estricta.
  • Averigua por qué desapareció el pie incluido aunque MJML terminó correctamente.
  • Adapta este boletín a Outlook con fuente y color de fondo alternativos.

Cómo instalar email-html-mjml

Compilador e inclusiones

Instala MJML en el proyecto destino y fija una versión compatible. La carpeta de la skill no instala el compilador.

MJML 5 desactiva las inclusiones por defecto. Actívalas y permite sus directorios expresamente; verifica contenido conocido en el resultado.

Una skill es una carpeta con un archivo SKILL.md. La instalas una vez; el agente lee su breve descripción al empezar cada sesión y carga las instrucciones completas solo cuando una petición encaja. Elige dónde la usas:

Claude Code: copia la carpeta en tu carpeta de skills

Pon la carpeta de la skill en ~/.claude/skills/ para usarla en todos los proyectos de este ordenador, o en .claude/skills/ dentro de un repositorio para compartirla con todos los que trabajan en él (haz 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 detecta las skills nuevas o modificadas en estas carpetas durante la sesión. Si la carpeta de skills no existía al empezar la sesión, ejecuta /reload-skills una vez. Después escribe /email-html-mjml o simplemente describe la tarea.

En Windows, ejecuta los comandos en Git Bash o WSL, o copia la carpeta al mismo sitio con el Explorador de archivos.

Codex, Gemini CLI, Cursor y GitHub Copilot

Estos agentes leen las mismas carpetas SKILL.md. La única carpeta que aceptan los cuatro dentro de un proyecto es .agents/skills/, así que esto copia la skill ahí:

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/
AgenteCarpeta del proyectoTu carpeta de usuarioNotas
OpenAI Codex
.agents/skills/
~/.agents/skills/
Escribe $ o ejecuta /skills para elegir una skill; Codex también elige una cuando tu tarea encaja.
Gemini CLI
.agents/skills/
.gemini/skills/
~/.agents/skills/
~/.gemini/skills/
O instálala desde Git con gemini skills install <git URL> --path <folder> --consent. El 18 de junio de 2026, Google sustituyó Gemini CLI por Antigravity CLI para los usuarios del nivel gratuito y de Google One; Antigravity usa .agents/skills/ en un proyecto y ~/.gemini/config/skills/ para ti.
Cursor
.agents/skills/
.cursor/skills/
~/.agents/skills/
~/.cursor/skills/
Escribe / en el chat de Agent para elegir una skill. Cursor también lee las carpetas .claude/skills/ de Claude Code.
GitHub Copilot
.github/skills/
.agents/skills/
.claude/skills/
~/.copilot/skills/
~/.agents/skills/
Funciona en Copilot CLI, en el agente en la nube y en el modo agente de VS Code, Visual Studio y JetBrains (la compatibilidad con cada IDE depende de la versión). O ejecuta gh skill install OWNER/REPOSITORY SKILL (vista previa pública, GitHub CLI 2.90.0 o posterior).
Instala solo skills de confianza. Anthropic aconseja usar solo skills de fuentes de confianza y leer todos los archivos de cualquier otra skill antes de usarla: una skill puede indicar al agente que ejecute comandos, lea archivos o envíe datos de formas que su descripción no menciona.

Fuentes de estos pasos

Comprobado con la documentación de cada proveedor el 2026-11-14:

Compilar es una comprobación

Revisa resultado, tamaño, contenido incluido y estilos alternativos. Minificar no garantiza quedar por debajo del límite de recorte de Gmail.

Probar el renderizado en los clientes usados por los destinatarios sigue siendo una comprobación de publicación aparte.

Preguntas sobre email-html-mjml

¿Envía correos?

No. Genera fuente y HTML; la entrega y las plataformas de campañas son independientes.

¿Por qué conservar ambos archivos?

MJML sigue siendo editable; el HTML compilado se entrega al servicio de envío.

¿El modo estricto detecta inclusiones ausentes?

No siempre. La fuente advierte que inclusiones desactivadas o denegadas pueden omitirse sin código de salida de error.

¿Funciona en Claude.ai o mediante API?

Puede redactar la fuente, pero aquí no se ha verificado la compilación Node completa en esos entornos aislados.

Más skills de IA

Skills relacionadas

Categorías de skills