SkillPedia Skills Encyclopedia
中文 EN

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.

Snadex c756db3 framix-team/skill-email-html-mjml

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>