hermes

Write a newsletter welcome email

Writes a newsletter welcome email that confirms the promise, sets expectations, surfaces the best past issues and starts a reply conversation. Use on Substack, beehiiv, Ghost or similar.

context

You write welcome emails for newsletters. The welcome email is usually the most-read email a newsletter sends, because it arrives when interest is highest. It has four jobs: confirm the subscriber made a good choice by restating the promise; set expectations (what arrives, when, how often, how long it takes to read); give them something good to read right now; and start a two-way relationship. Asking for a reply does double duty: it tells the writer who the readers are, and replies help mail providers treat future issues as wanted mail rather than promotions or spam.

task
newsletter

best issues

author voice

  1. Write three subject line options: warm, specific to the newsletter, and clearly a welcome (not a sales pitch).
  2. Write preview text that complements the subject line rather than repeating it.
  3. Write the email, in the author's voice, in this order:
  • A short, personal welcome and the newsletter's promise in one or two sentences.
  • Expectations: what each issue contains, the send day and frequency, typical reading time, and anything else they get (archive, community, paid tier) in one line each.
  • "Start here": the best past issues, each with its title as a link and one line on why to read it. If none were given, offer one useful thing instead (the most useful idea of the newsletter in a few sentences, or what the first issue will cover) and do not invent issue titles.
  • One reply prompt: a single specific question that is easy to answer and useful to the writer (for example what they hope to get, or their biggest challenge with the topic).
  • A short line on making sure issues arrive (moving it to the main inbox or adding the sender to contacts), without technical jargon.
  • A sign-off in the author's voice.
  1. Add setup notes: where to paste it on the platform, a reminder to set a fallback for any first-name merge tag, and to send a test to more than one email provider.
constraints
  • Keep the email under about 250 words. It should read like a note from a person, not a brochure.
  • One reply question only, and no other calls to action except the start-here links.
  • Never invent past issue titles, links, subscriber counts or testimonials. Use [LINK] or [ISSUE TITLE] placeholders if something is missing.
  • Use a generic placeholder such as [FIRST_NAME] for personalisation rather than a platform-specific merge tag, unless the user named the platform's syntax.
  • If no voice sample is given, write plainly and warmly in the first person, and say so in the setup notes.
output format

Subject lines

Three numbered options.

Preview text

One line.

Email

Ready to paste, with Markdown links.

Setup notes

A short checklist, including any placeholders to fill.

1 required value still a placeholder; the assistant will ask for it.

details

kind
Prompt: a task you run by name to get one finished thing back
domain
Content creation
category
Newsletters
level
Beginner
made for
Writer / author, Content creator, Marketer
risk
read-only
version
v1.0.0 · incubating
reviewed
2026-10-02
works in
Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Antigravity, OpenCode, Windsurf, Zed, Continue, AGENTS.md, ChatGPT, claude.ai

Edit on GitHubReport a problem

use in

Hodios CLI
npx @hermes-hq/hodios install write-newsletter-welcome-email --target claude-code
Agent Skills
npx skills add hermes-hq/hodios-dist --skill write-newsletter-welcome-email -a claude-code
Add the Hodios marketplace (once)
claude plugin marketplace add hermes-hq/hodios-dist
Install the content-creation plugin
claude plugin install hodios-content-creation@hodios

The plugin brings every entry in this domain at once.

pairs well with

All of Newsletters
PromptNewsletters

Plan a newsletter format

Designs a newsletter's positioning, recurring sections, length, cadence, voice and a sample issue skeleton based on the audience and sustainable effort. Use when starting or relaunching one.

plan-newsletter-format
PromptNewsletters

Grow a newsletter

Builds a subscriber growth plan with signup placement, lead magnets, referrals and cross-promotion, social funnels, weekly actions and metrics to watch. Use when newsletter growth has stalled.

grow-newsletter
PromptNewsletters

Write a newsletter issue

Writes a newsletter issue from notes and links in the author's voice, with subject lines, preview text, an intro, sections and a sign-off. Use when turning rough notes into an issue.

write-newsletter-issue
PromptNewsletters

Curate a link roundup

Turns a list of links and notes into a curated roundup with a theme, a one-line why-it-matters for each link and a clear cut list. Use when writing a weekly links newsletter section.

curate-link-roundup
PromptNewsletters

Write a community digest

Writes a digest for a club, school, neighbourhood or association from scattered updates, with events, decisions, volunteer asks and contact points. Use for a weekly or monthly community update.

write-community-digest