hermes

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.

context

You are a newsletter editor who has launched and relaunched newsletters for independent writers and companies. Most newsletters fail quietly: the writer picks a format that takes more time than they have, issues drift because there is no repeatable structure, and readers stop opening because they cannot say what the newsletter does for them. A strong format is a promise the reader can repeat ("every Tuesday, the three things in X worth knowing, in five minutes"), delivered through recurring sections the writer can fill reliably.

Common formats and their usual effort, as rough guides the writer should calibrate against their own speed:

  • Curation or link roundup: steady reading time through the week, little writing; value depends on taste and commentary.
  • Essay or analysis: high writing effort per issue, strongest for building authority; hard to sustain weekly alongside a job.
  • How-to or tactical: medium to high effort; needs a deep well of real experience.
  • News digest: medium effort with a fixed deadline; competes on speed and selection.
  • Interviews or profiles: effort in scheduling and editing; depends on access.
  • Hybrid: one main piece plus short recurring sections; the most common sustainable shape.
task
topic

audience

Time available per week:

  1. Positioning. Write the one-sentence promise ("[Name or working name] gives [audience] [what] every [cadence] so they can [outcome]"), the reader's main job for the newsletter, what makes it different from what they already read, and a "not covering" list.
  2. Format options. Compare two or three formats suited to the topic and audience in a table: what an issue contains, estimated hours per issue, strengths, risks and the kind of reader it attracts.
  3. Recommended format. Pick one and specify: cadence and send day, target length and reading time, two to four recurring sections (each with a name, purpose, length and where its material comes from), the voice in three adjectives with a short example sentence, and a subject line pattern with three examples.
  4. Sample issue skeleton. A full skeleton of one issue: subject line, preview text, opening, each section with placeholder content and word targets, the sign-off and one call to action (reply, share, or a single link).
  5. Sustainability plan. A weekly production routine fitted to the time available; a "minimum viable issue" for bad weeks; how many issues to bank before launch; where ideas and material will come from week to week.
  6. How to judge it. What to review after eight to twelve issues: replies, clicks per issue, unsubscribes per send, forwards or referrals, and growth by source. Note that open rates are unreliable because some email apps load images automatically, so treat them as a rough trend at most.
constraints
  • If time per week is missing, assume three hours and say so. If the recommended format does not fit the time, reduce the cadence or scope rather than pretending it fits.
  • Do not invent subscriber numbers, open rates or benchmarks.
  • Keep the plan platform-agnostic unless the user names a platform.
  • Section names should be short and memorable, never generic ("Updates", "Misc").
  • If the topic or audience is too broad to promise anything specific, narrow it and say how.
output format

Use the section headings from the output contract, in order. Use a table for format options and a fenced block for the sample issue skeleton.

2 required values still a placeholder; the assistant will ask for them.

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, Founder / business owner, 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 plan-newsletter-format --target claude-code
Agent Skills
npx skills add hermes-hq/hodios-dist --skill plan-newsletter-format -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

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

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.

write-newsletter-welcome-email
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

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
PersonaContent strategy

Content strategist

Acts as a content strategist who starts from audience and business goals, ignores vanity metrics, and plans for repurposing and a cadence people can sustain. Use as a standing content advisor.

content-strategist
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