Agent skill · writing content · aiskillstore
converting-email-templates
Use when converting or migrating email templates from another provider (SendGrid, Mailgun, Mandrill, Postmark, Brevo, Amazon SES) to Mailtrap-compatible Handlebars syntax. Supports single file, bulk directory, and inline HTML conversion.
Why this skill is useful
Adds a Python script for converting email templates to Mailtrap-compatible Handlebars syntax, which is not commonly found in public documentation.
What it needs
Requires python3 installed locally. About 4k tokens when loaded. Last updated 2026-08-07. 405 stars on the source repository.
What this skill does
Converting email templates Purpose Automatically convert email templates from other email service providers into Mailtrap-compatible Handlebars syntax. Handles both deterministic pattern conversions (via a Python script) and complex edge cases (via LLM intelligence). Related skills: using-email-templates (Handlebars syntax, API template send), sending-emails (stream bases and auth), authorizing-api-requests (tokens, env vars, accountid resolution — needed when creating templates or sending via the Templates API after conversion). Input Source provider (required): sendgrid, mailgun, mandrill-handlebars, mandrill-mergetags, postmark, brevo, or ses Input: a single template file path, a directory of .html template files, or raw HTML pasted inline Output directory (optional): defaults to a /converted/ subdirectory next to the input If the user does not specify the source provider, ask before proceeding. If the user provides template HTML inline (pasted in chat), save it to a temporary .html file first. Workflow Step 1: Detect mode Fast mode (default): For providers with deterministic conversion patterns. The Python script handles these reliably. Deep mode: Triggered when: Provider is brevo AND the template contains nested loops, multiple filters, or complex conditional nesting The script flags patterns that could benefit from LLM judgment The user explicitly requests deep mode Inline HTML is provided (run LLM conversion directly) Step 2: Run the converter script Execute the Python converter script: Where {skilldir} is the directory containing this SKILL.md file. Read the output: Exit code 0: clean conversion, no flags. Proceed to Step 4. Exit code 1: conversion completed with flags. Proceed to Step 3. Exit code 2: error. Report to user and stop. Read the .report.txt file(s) generated alongside each converted template. For bulk conversions, also read summary.txt. Note: When flags are present, the script automatically: Prepends a <!-- WARNING: ... …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills aiskillstore/converting-email-templates