Email HTML QA Skill — Testing skill for Claude Code

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
 
   
 
 
QA Deliver
   
Deliver a QA run (summary, video, report) to the channels listed in qa.config.yaml - Telegram, WhatsApp, Slack
 
  Testing community 
 
   
 
 
Gstack Ko
   
Use Garry Tan's exact Claude Code setup: 6 opinionated tools that serve as CEO, Eng Manager, Release Manager a
 
  Testing community 
 
   
 
 
Nereus
   
An opinionated development harness for Claude Code — interview → spec → TDD build → parallel review → finish,
 
  Testing community 
 
   
 
 
Leads Research
   
Research every lead in a CSV into a reviewable leads-spec.md — per-lead dossier (who / fit verdict / drafted e
 
  Testing community 
 
   
 
 
Leads Deliver
   
Send the approved outreach — reads leads-spec.md, sends only ✅ leads after a count + sample confirmation (Gmai
 
  Testing community 
 
   
 
 
Gtm QA
   
Run autonomous QA verification on any GTM deployment — pixel fires, funnel walkthroughs, mobile testing, perfo
 
  Testing community 
 
  
 
 
Related Agents
 
   
 
 
Email Wizard
   
Email campaign orchestration specialist. Use for creating sequence templates, dynamic personalization, send-ti
 
  Development community 
 
   
 
 
Comms Agent
   
Draft follow-up messages for job-search contacts (email / LinkedIn / WhatsApp), queue them for the user's appr
 
  Development community 
 
   
 
 
Draft Writer
   
Writes one outbound draft (email, LinkedIn post, follow-up message) to a file under outputs/ and stops there.
 
  Content & Marketing community