> ## Documentation Index
> Fetch the complete documentation index at: https://www.opendirectory.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# email-newsletter

> Draft and design a complete HTML email newsletter from a topic or content brief. Output is paste-ready for Loops, Mailchimp, Beehiiv, Resend, or any standard...

<Info>
  **Category:** Content · **Version:** `1.0.0` · **Author:** `OpenDirectory` · **Compatibility:** All targets (claude, codex, opencode, gemini, anti-gravity, openclaw, hermes)
</Info>

Draft and design a complete HTML email newsletter from a topic or content brief. Output is paste-ready for Loops, Mailchimp, Beehiiv, Resend, or any standard email platform.

## Install

<Tabs>
  <Tab title="npx CLI (Recommended)">
    ```bash theme={null}
    npx "@opendirectory.dev/skills" install email-newsletter --target claude
    ```
  </Tab>

  <Tab title="skills.sh">
    ```bash theme={null}
    npx skills add Varnan-Tech/opendirectory --skill email-newsletter
    ```
  </Tab>

  <Tab title="Claude Code Native">
    ```bash theme={null}
    /plugin marketplace add Varnan-Tech/opendirectory
    /plugin install opendirectory-gtm-skills@opendirectory-marketplace
    ```
  </Tab>

  <Tab title="Claude Desktop">
    <video controls className="w-full aspect-video rounded-xl mb-4" src="https://github.com/user-attachments/assets/cea8b565-2002-4a87-8857-d902bfcfdc1c" />

    1. Copy `https://github.com/Varnan-Tech/opendirectory/tree/main/skills/email-newsletter` into [download-directory.github.io](https://download-directory.github.io/) to download the ZIP.
    2. Open **Claude Desktop** -> **Customize** -> **Skills** -> **+** -> **Upload a skill** and drop the folder containing `SKILL.md`.
  </Tab>

  <Tab title="Manus AI">
    <video controls className="w-full aspect-video rounded-xl mb-4" src="https://github.com/user-attachments/assets/17cbee2a-9e17-4bd4-ac46-68e0e92ffab4" />

    [**Install email-newsletter in Manus AI**](https://manus.im/import-skills?githubUrl=https%3A%2F%2Fgithub.com%2FVarnan-Tech%2Fopendirectory%2Ftree%2Fmain%2Fskills%2Femail-newsletter\&utm_source=opendirectory)
  </Tab>
</Tabs>

## What it does

* Asks the 19 questions that actually determine your newsletter layout
* Writes all sections: hero, intro, main content, stat callout, CTA, footer
* Generates table-based HTML with inline styles -- compatible with every major email client
* Tunes variable syntax per platform (Loops, Mailchimp, Beehiiv, Resend)
* Produces 3 subject line options using proven formulas
* Includes a plain-text fallback for deliverability

## Example

> "Write a newsletter about how AI is changing B2B sales. Audience: VPs of Sales at 100-500 person SaaS companies. CTA: join our upcoming webinar. Tone: direct. Platform: Beehiiv."

Output: full HTML email with hero headline, 3-section body, stat callout, CTA block, and footer -- plus 3 subject line options and a plain-text version, tuned for Beehiiv.

## Supported platforms

| Platform | Notes |
| - | - |
| Loops | `{{unsubscribe_url}}` syntax. Paste into custom HTML editor |
| Mailchimp | `*\|UNSUB\|*` syntax. Use "Code your own" template. Includes `mc:edit` regions |
| Beehiiv | `%%unsubscribe_url%%` syntax. Works with custom HTML block |
| Resend | `{unsubscribeUrl}` syntax. React Email `.tsx` output available on request |
| Generic | `[UNSUBSCRIBE_URL]` placeholder -- replace before sending |

## Output formats

* **Standard HTML** (default): inline-styled, table-based, 600px max-width
* **Plain text**: always included unless you opt out
* **React Email** (on request): `.tsx` component output for Resend / dev teams

## Parameters

| Param | Required | Notes |
| - | - | - |
| topic | Yes | What the newsletter is about |
| audience | Yes | Who is reading |
| cta | Yes | Primary action you want readers to take |
| company\_name | No | Brand name for header and footer |
| tagline | No | One-line description for footer |
| city\_country | No | Footer location (e.g. "San Francisco, US") |
| cta\_url | No | Actual link for CTA button -- placeholder used if omitted |
| brand\_color | No | Hex code -- used for strip, stat border, category label |
| background | No | dark / light / custom hex (default: dark) |
| display\_font | No | editorial serif / modern sans / system fonts (default: Instrument Serif) |
| button\_style | No | pill / softly rounded / sharp (default: pill) |
| visual\_style | No | editorial / technical+data / warm+founder / bold+campaign |
| tone | No | educational / conversational / bold+direct / formal / playful |
| platform | No | loops / mailchimp / beehiiv / resend (default: generic) |
| personalization | No | none / first name / first name + company (default: none) |
| length | No | brief (300w) / standard (500-700w) / deep dive (800w+) |
| format | No | editorial article / numbered breakdown / personal story / data report |
| subject\_line | No | If omitted, 3 options are suggested |
| secondary\_sections | No | sponsor block / product callout / event / quick links |

## No API keys required

Pure AI skill. No external services, no scraping, no dependencies to install.

## Design principles

* Max width 600px (email client standard)
* Inline styles only -- no external CSS, email clients strip it
* Table-based layout for Outlook compatibility
* Georgia serif for hero headlines, Arial/system font for body
* CTA buttons use the table+td VML-compatible structure
* All images include alt text
* Dark mode aware where platform supports it


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.