mailchimp-claude-skills
Claude Code skills for authoring custom-coded Mailchimp email templates. The skill handles the correctness layer — MCTL placement, responsive tables, Outlook hardening, accessibility, compliance — so your prompt can focus on brand, content, and structure.
Built and maintained by michtio at Bleu Chaud.
Support
If this project saves you time, consider supporting its development:
Quick Start
1. Install
# Claude Code Plugin (recommended)
# First time: add the marketplace, then install
/plugin marketplace add michtio/mailchimp-claude-skills
/plugin install mailchimp-claude-skills@mailchimp-claude-skills
# Or clone manually
git clone https://github.com/michtio/mailchimp-claude-skills.git ~/.claude/mailchimp-claude-skills
cd ~/.claude/mailchimp-claude-skills && bash install.sh
install.sh symlinks every skill (any directory containing a SKILL.md) into ~/.claude/skills/, so updates flow through with git pull. bash uninstall.sh removes the symlinks; manually-installed skills are never touched.
For Claude.ai or the Anthropic API, see Installation methods below.
2. Describe Your Template
Open Claude Code in any working directory and describe what you need. Skills trigger automatically based on the prompt.
Build a Mailchimp newsletter template for Acme Logistics, monthly availabilities
update. Palette: foreground #1a1d2e, accent #2563eb, white background. Headings
in Manrope, body in Inter, both with Arial fallback. Sections: hero, repeatable
country blocks with 3 cards each, hideable sustainability section, footer with
address and unsubscribe. Validate before declaring done.
The skill loads its responsive scaffold, fills the brand inputs, places MCTL attributes correctly, hooks up compliance tags, and runs the validator.
3. Validate & Ship
# Validate locally before uploading
python3 mailchimp-template-language/scripts/validate.py template.html
# Exit 0 = clean, 1 = errors found, 2 = file not found
# Use --strict to fail on warnings too (CI-friendly)
Then paste into Mailchimp's "Code your own → Paste in code" flow, or upload programmatically via a Mailchimp MCP server.
Example Prompts
Just describe what you need. The skill triggers on Mailchimp / MCTL / merge-tag mentions and produces validator-clean templates.
Build a Mailchimp template for our quarterly product update. Single hero with
big number ("Q2 in numbers"), three stat cards (active users, exports
processed, new integrations), then a repeatable feature-highlights section,
then a compliance footer. WCAG 2.2 AA. Inter via Google Fonts with Arial
fallback.
Convert this static HTML email into a Mailchimp-editable template. Mark the
header, body, and footer as mc:edit regions. Add a repeatable card row.
The "Featured" callout should be hideable. Keep the existing styling.
Add a French-language version of this template. Copy the file, set lang to
fr-BE, translate the hero eyebrow and CTA labels, keep everything else
identical. The compliance footer copy needs to be French too.
Our current Mailchimp templates don't share mc:edit names so editors lose
content when switching templates. Audit these three templates and normalize
the editable region names so Switch Template works cleanly across them.
A subscriber reported that our last campaign's hero image is missing alt text
and the unsubscribe link is hard to find on mobile. Audit our base template
for accessibility issues — WCAG 2.2 AA — and fix what you find.
Build a re-engagement campaign template. Empathetic opener, three highlights
of what they've missed (hideable), a clear reactivation CTA, plus an explicit
soft-exit unsubscribe section with positive framing. Editorial type, no
hype.
What's Inside
Skills
| Skill | What it does |
|---|
mailchimp-template-language | Authors custom-coded responsive MCTL templates with full mc:edit / mc:repeatable / mc:variant / mc:hideable support, merge tags, conditional blocks, Outlook hardening, accessibility, and CSS inlining workflow. 9 reference files. |
mailchimp-multilingual | Plans and builds multilingual campaigns — MC_LANGUAGE field, IF:MC_LANGUAGE=xx conditional content, segments-vs-conditional decision tree, multi-market template forking. Companion-loads the template-language skill for the underlying HTML. 4 reference files. |
Agents
