Email Html Qa Skill

Email HTML QA Skill for Claude

An opinionated, pre-send **QA pass for HTML email** — the mechanical and craft checks that catch what actually breaks in the inbox, built from real production experience by [EmailBoutique](https://emailboutique.io).

Email is not the web. The goal is **robust and graceful**, never pixel-perfect.

Quick start (no Claude required)

It's a plain Python script with **zero dependencies** — run it on any HTML email:

python scripts/lint_email_html.py your-email.html

Every check reports **PASS / WARN / FAIL**, so you see what's good as well as what needs a look:

Email HTML lint — your-email.html
======================================================
PASS  HTML size 72.3 KB (under the ~90 KB budget)
PASS  charset utf-8 declared
WARN  no lang attribute on  (accessibility: set e.g. lang="en")
WARN  3 of 12  missing alt (decorative → alt="")
PASS  live text present (not image-only)
WARN  8 of 9  lack role="presentation"
FAIL  1 link(s) are '#'/empty/localhost — placeholder/broken hrefs
PASS  preheader / preview-text block detected
WARN  no 'unsubscribe' found — confirm the specified compliance element is present
======================================================
4 passed · 4 warning(s) · 1 failure(s) — run the full QA checklist next.
PASS — the check is clean.
WARN — should fix; may degrade rendering or accessibility.
FAIL — will break for many recipients; fix before sending.
It flags size/Gmail-clipping, missing `alt`, missing `charset`/`lang`, layout
tables without `role="presentation"`, empty/`#` links, missing preheader, and
whether a compliance/unsubscribe element is present — the boring stuff, caught
cheaply, before you spend attention on craft.
Use it with Claude (optional)
If you use Claude, the `SKILL.md` gives it the full QA process — rendering across
clients (Outlook Windows/Mac, Gmail, Apple Mail/iOS), **forced dark mode**,
responsive/mobile, accessibility, ima
 
Related Skills
 
   
 
 
Spec Kit
  
💫 Toolkit to help you get started with Spec-Driven Development
 
  Testing  
 
   
 
 
Webapp Testing
  
Test local web applications using Playwright for UI verification and debugging
 
  Testing  
 
   
 
 
#29
  
, [#52](https://github.com/affaan-m/everything-claude-code/issues/52), [#103](https://github.com/affaan-m/ever
 
  Testing  
 
   
 
 
Fix Issue
  
by metabase - Addresses GitHub issues by taking issue number as parameter, analyzing context, implementing sol
 
  Testing  
 
   
 
 
Pypict Test Design
  
Design comprehensive test cases using PICT (Pairwise Independent Combinatorial Testing) for optimized test sui
 
  Testing  
 
   
 
 
gstack
  
| 15,000+ | Garry Tan's exact Claude Code setup: 6 opinionated tools that serve as CEO, Eng Manager, Release M
 
  Testing