Skills 2026-08-10 20:45 UTC
skill-email-html-mjmlv4.15.3
Version [4.15.3] committed by Snadex. Update Category: Bug Fixes & Stability Improvements. Commit details: Fix minify rationale, hero defaults, and example rule violations. This update resolves known runtime errors and enhances system reliability.
CommitRaw commit message
Fix minify rationale, hero defaults, and example rule violations
Second correction pass, from a v4.15.3-vs-5.4.0 A/B comparison. Includes
a fix to a wrong line I introduced in e317859.
**The minify/stacking rationale was false in v5** — stated in six places.
html-minifier removed inter-tag whitespace; htmlnano collapses it to a
single space. Measured on the same mj-group template with the same flags:
v4 emits `<![endif]--><div class="mj-column-per-50"`, v5 emits
`<![endif]--> <div ...` (0 vs 44 occurrences of "> <"). What actually
prevents column stacking is the font-size:0px MJML puts on the parent
<td>, emitted in both versions — so the fix is to correct the REASON, not
to claim emails now break. I did not reproduce actual stacking, and the
docs no longer assert either way. `--config.minifyOptions
'{"collapseWhitespace":"all"}'` restores v4 stripping.
Correcting e317859: I wrote that minification options "move to
.mjmlconfig.js". They do not — --config.minifyOptions works from the CLI
(the JSON-string form; the dotted form fails to parse). Also softened
"more aggressively minified", which is release-note phrasing: v5 minifies
CSS more but HTML whitespace less.
- mj-hero `mode` documented as defaulting to fluid-height; the real
default is fixed-height with height:0px, so a hero without `mode`
compiles clean and renders invisible. Identical in v4 — a long-standing
doc bug, hidden because both worked examples set mode explicitly.
- mj-hero no longer accepts container-background-color: exit 1 under
strict in v5, exit 0 in v4. mjml-reference.md claimed it was available
on all body components.
- Refining my own bare-`<` wording from 1d99ca5: v5 does NOT error on
`Price < 100` (v4 did — hard Parse Error). Only a tag-like `<` followed
by a letter silently corrupts. My previous text was over-broad.
- basic-layout.mjml violated the rules it sits beside: 4 images with no
alt (Rule 6), "Helvetica Neue" with no fallback stack (Rule 3), no
mj-title or lang. Fixed rather than disclaimed — it is the first thing
an AI pattern-matches on.
- interactive.md documented mj-accordion/mj-carousel approvingly with no
warning while SKILL.md Rule 8 forbids them; the "falls back to..." notes
read as reassurance. Warning now leads the file.
- mj-wrapper gutter undocumented; mj-social-element icon-position default
is left (was absent in v4); README lagged on all v5 gotchas.
Credit to the gap-auditor subagent, which installed MJML 4.15.3 to get
these by comparison. Its packaging audit found no issues: `npx skills add`
resolves this layout correctly.
All four examples compile clean under strict+minify and none violate the
corrected rules.
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>