Email HTML QA

Opinionated, pre-send QA for HTML email. Use when reviewing, auditing, or QA-ing HTML email code before it ships — checking rendering across clients (Outlook Windows/Mac, Gmail, Apple Mail/iOS), forced dark mode, responsive / mobile, code size and Gmail clipping, accessibility mechanics, images, links/CTAs, preheader, personalization fallbacks, and that client-specified compliance elements are present and functional. Also reads and reports the authentication results (SPF/DKIM/DMARC) and unsubscribe headers from a received message. Reports findings by severity and diagnoses before changing code

6 starsProductivity & Notes

Install

skills CLI (Claude Code, Cursor, Codex and more)

npx skills add EmailBoutique-Digital-Inc/email-html-qa-skill --skill email-html-qa

Manual install

git clone --depth 1 https://github.com/EmailBoutique-Digital-Inc/email-html-qa-skill.git /tmp/email-html-qa-skill
mkdir -p ~/.claude/skills
cp -r /tmp/email-html-qa-skill/. ~/.claude/skills/email-html-qa

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# Email HTML QA

A repeatable, opinionated review pass for HTML email, built from real production
experience. Email is not the web: table-based layout, inconsistent CSS support,
and every client renders differently — so QA is about **robust and graceful**,
never pixel-perfect.

## How to run it
1. **If you have the HTML file, run the linter first** — a cheap mechanical pre-check:
   `python scripts/lint_email_html.py path/to/email.html`
   It flags size/clipping, missing `alt`, missing `charset`/`lang`, whether dark
   mode is targeted (the `color-scheme` opt-in), **transparent logos/icons that may
   vanish on a dark background**, layout tables without `role="presentation"`,
   empty/`#` links, **unlinked images** (Gmail-lightbox / lost CTA), missing
   **auto-link suppression** (blue-link risk), missing preheader, and missing
   compliance elements. Fix the boring stuff before spending human attention on craft.
2. **For a sent message, run the header check** — on the raw `.eml` as *received*:
   `python scripts/lint_email_headers.py path/to/message.eml`
   It reports the SPF/DKIM/DMARC results the receiver recorded, checks
   `List-Unsubscribe` + RFC 8058 one-click, and takes a best-effort guess at the
   sending ESP. Run it on a message as received — the pre-send HTML has no auth
   headers yet. It **reports** the recorded results; it does not fix deliverability.
3. **Then work the checklist below**, section by section.

Read the full skill on GitHub

Details

Skill name: email-html-qa
Repository: EmailBoutique-Digital-Inc/email-html-qa-skill
License: MIT
Repo updated: 1 September 2026

FAQ

What does the Email HTML QA skill do?

How do I install the Email HTML QA skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add EmailBoutique-Digital-Inc/email-html-qa-skill --skill email-html-qa. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Email HTML QA popular?

It lives in EmailBoutique-Digital-Inc/email-html-qa-skill, which has 6 GitHub stars and 0 forks.

Related skills

Lecture Notes

orhoncan/lecture-notes-skill

Generate comprehensive undergraduate lecture notes for social sciences (especially economics) with mathematical foundations, daily-life examples, and practice questions. Use when user asks to create, generate, or write lecture notes, lecture materials, or teaching content. Supports Turkish and English output, Obsidian-compatible markdown with LaTeX/TikZ, and optional syllabus integration.

Productivity & Notes

Release Calendar

jefflinshu/release-calendar-skill

Generate a beautiful "Everything [Team] shipped in X days" release calendar poster — like the viral Anthropic/OpenAI/Codex shipping velocity images. Given a company name, X handles, and date range, this skill pulls real tweets, identifies product releases, and renders a brand-matched HTML calendar with team avatars and click-through tweet links. Trigger phrases (Chinese 🇨🇳): - "帮我做一个 [公司] 的 release calendar" - "做一张 shipped in X days 的图" - "复刻那张 Anthropic releases 图" / "复刻那张 OpenAI/Codex 图" - "做 [产品] 的发布日历" / "[公司]的发布日历" - "[公司] 发了多少东西" / "盘点一下 [公司] 发布了什么" - "做个发布速度图" / "做个 shipping velocity

Productivity & Notes

Workflow Herdr

letya999/workflow-herdr

Start a Herdr work run for a change. Use when starting work, doing a task in Herdr, splitting work across panes, or chatting from a Herdr terminal - even if they just say do this. Do NOT use for a solo one-pane edit, headless delegates, or product job queues.

Productivity & Notes

Second Brain

stancsz/second-brain

Use when the user wants to save durable knowledge, recall or connect their own notes, inspect knowledge gaps, manage a local personal wiki, exchange notes with Obsidian, or create and restore verified backups. Operates a local OKF Markdown knowledge graph with a rebuildable SQLite index.

Productivity & Notes

Depth Lock

malakhov-dmitrii/depth-lock

Lock scope, review rounds and wall-clock checkpoints before non-trivial work, and send everything outside the task to follow-ups. Use at the start of any plan, feature, fix train or multi-agent workflow, when a review loop starts repeating, when findings drift beyond the task, or when the operator says "не полируй", "не растягивай", "полировка круглого камня", "stop polishing" or "timebox".

Productivity & Notes

Email Design

CosmoBlk/email-design

Design distinctive, on-brand emails — newsletters, campaigns, welcome series, promo, post-purchase, win-back, transactional, announcements. Use when the user wants to draft, write, compose, design, redesign, critique, polish, or improve an email; or send a campaign / blast / broadcast through any ESP (Nitrosend, Klaviyo, Mailchimp, ActiveCampaign, etc.). Produces a structured design brief and translates it into the sending tool's section format. Bakes in anti-slop principles: own a colour, restrained palettes, real imagery with sourced or prompted image slots, distinctive voice, no category-re

Productivity & Notes

Browse the most popular Claude skills, all productivity & notes skills, or write your own with the skills generator.