Newsletter system

01What is it?
Design, write, and grow editorial newsletters with consistent voice and format. Creates newsletter strategy, templates, and growth playbook. Its edge is a particular angle on email marketing, giving the agent tighter constraints than a plain newsletter system request.
02Inputs
Context for email marketing: your goals, audience, constraints, and any source material the skill asks for.
03Output
A ready-to-use result for email marketing: the analysis, copy, or recommendations the agent produces.
Install-only

Install as a package

Installs this one skill package for your coding agent, including any supporting files that skill ships with — not every skill in the repository. Read the tutorial.

Terminal
$ npx skills add moizibnyousaf/marketing-cli --skill newsletter

Skill instructions

The instruction file for this skill. The skill also includes other files you need to install to use it.

SKILL.md

Newsletter System

You design and write editorial newsletters that people actually look forward to receiving. Not corporate updates nobody reads — opinionated, valuable, personality-driven emails that build an audience over time.

On Activation

  1. Read brand/voice-profile.md — newsletters live or die by voice consistency
  2. Read brand/audience.md — understand what they care about, how sophisticated they are
  3. If starting fresh, ask: What's the newsletter about? Who's it for? What format appeals to you?
  4. Check marketing/newsletter/ for existing strategy and past issues

Brand Integration

  • voice-profile.md → Newsletters live or die by voice consistency. If voice is warm/conversational, use 'I' perspective with personal anecdotes. If authoritative/editorial, use curated insights with expert framing. The voice must feel like a person writing, not a company broadcasting.
  • audience.md → Content selection and depth matches audience sophistication. Technical audience gets deep dives. General audience gets accessible summaries with links to learn more.

Step 1: Define the Newsletter

Newsletter Types

TypeDescriptionBest ForExample
CuratedBest links + your commentaryIndustry watchers, busy professionalsThe Hustle, TLDR
EditorialOriginal essays/insightsThought leaders, opinionated foundersStratechery, Lenny's Newsletter
HybridMix of original + curatedMost founders and creatorsMorning Brew, Dense Discovery
Product updateWhat's new in your productSaaS companies with active usersLinear, Notion changelogs
EducationalTeaches one skill per issueCourse creators, consultantsJames Clear, Marketing Examples

Strategy Doc

Before writing a single issue, establish:

---
name: "Newsletter Name"
tagline: "One-line value prop (what they get + how often)"
type: curated | editorial | hybrid | product | educational
frequency: weekly | biweekly | daily
send_day: Tuesday
send_time: "9:00 AM ET"
target_audience: "Who specifically reads this"
core_topic: "The single topic area"
voice: "How it sounds (reference voice-profile.md)"
success_metric: "Open rate > 40%, click rate > 5%"
---

Step 2: Build the Template

Every newsletter needs a repeatable structure readers come to expect.

Template Structure

# [Newsletter Name] — Issue #[N]

## [Catchy issue title or theme]

### Intro (2-3 sentences)
[Personal hook — what happened this week, what's on your mind, why this issue matters]

---

### Section 1: [Main Value Block]
[The core content — original insight, deep dive, or primary curation]

### Section 2: [Secondary Value]
[Supporting content, related links, or complementary angle]

### Section 3: [Quick Hits / Links]
- **[Link title]** — One-line commentary on why it matters
- **[Link title]** — One-line commentary
- **[Link title]** — One-line commentary

---

### [Recurring Section Name]
[Something predictable readers look forward to: tool of the week, quote, stat, hot take]

---

### CTA
[One primary ask: share, reply, check out product, visit link]

---

[Sign-off in your voice]
[Name]

[Footer: unsubscribe, share link, social links]

Format-Specific Templates

Curated Newsletter:

  • 5-7 links with 2-3 sentence commentary each
  • Group by theme or rank by importance
  • Your opinion is the value — don't just summarize

Editorial Newsletter:

  • One main essay (500-1,000 words)
  • Strong opening hook
  • Clear argument or insight
  • End with a question or call to reply

Hybrid Newsletter:

  • One short original piece (300-500 words)
  • 3-5 curated links with commentary
  • One recurring section (tool, quote, tip)

Step 3: Write an Issue

The Writing Process

  1. Choose the theme: One core topic per issue. No scatter.
  2. Write the hook: First 2 sentences determine if they read or archive. Make it personal, specific, or surprising.
  3. Deliver the value: The thing they subscribed for. Don't bury it.
  4. Keep sections scannable: Bold key phrases. Short paragraphs. Clear headers.
  5. Close with energy: A question, a challenge, a forward-looking tease.

Issue Output Format

---
issue_number: 42
title: "Issue title"
subject: "Email subject line"
preview: "Preview text"
theme: "Core topic"
send_date: 2026-03-12
word_count: 850
status: draft
---

Writing Rules

  • Personality first: Readers subscribe for your take, not the news itself
  • One idea per section: Don't cram. Each section has one job.
  • Scannable: Someone skimming should get 60% of the value. Bold key points.
  • Consistent length: Set an expectation and keep it. Plus or minus 20% variance max.
  • Predictable structure: Readers should know where to find what they want.
  • End with a question: The reply is the highest-engagement action. Invite it.

AI Tells to Avoid in Newsletters

Newsletters live or die on voice. Generic AI voice is fatal — readers unsubscribe from "content," they stay for a person.

Words to ban: delve, comprehensive, robust, utilize, landscape, navigate, foster, empower, elevate, streamline, crucial, leverage Phrases to ban: "In today's fast-paced world," "It's worth noting that," "Let's dive in," "Without further ado," "In conclusion" Structural tells: Every section same length. No personal anecdotes. No opinions without hedging. Perfect grammar everywhere (real newsletters have personality quirks). No contractions. The test: Read it aloud. If it sounds like a press release or a textbook, rewrite it. It should sound like a smart friend talking over coffee.


Step 4: Frequency Recommendations

FrequencyProsConsBest For
DailyHabit-forming, high engagementBurnout risk, high content demandNews, curation-heavy
WeeklySustainable, high quality per issueSlower growthMost creators and businesses
BiweeklyLow pressure, high qualityHarder to build habitIn-depth analysis, B2B
MonthlyMaximum qualityEasy to forget aboutReports, roundups

Default recommendation: Weekly. It's the sweet spot between staying top-of-mind and maintaining quality.


Step 5: Growth Assets (Agent-Actionable)

For each newsletter, generate these growth assets:

Signup Page Copy

Write a dedicated newsletter signup page with:

  • Headline: What they get + how often ("Weekly insights for founders building in public")
  • 3 bullet points: Specific value per issue
  • Social proof: Subscriber count, notable readers, or open rate stats
  • Single email field + subscribe button
  • "No spam. Unsubscribe anytime."

Welcome Email

Write the welcome email that triggers on signup:

  • Deliver on the promise (what to expect, when)
  • Ask for a reply ("What are you working on?") — boosts deliverability
  • Set the relationship tone from day one

Referral Copy

Write referral program copy with tiered rewards:

  • 1 referral: Bonus content (exclusive post, template, etc.)
  • 3 referrals: Free resource or community access
  • 10 referrals: Product discount or 1:1 consultation
  • Include the share CTA copy and referral email template

Cross-Promotion Outreach Template

Write a cross-promo pitch email for newsletters of similar size:

  • Introduce your newsletter (subscriber count, niche, open rate)
  • Propose mutual recommendation
  • Keep it short, genuine, no-strings

Social Teaser Copy

For each issue, generate 1-2 social posts that share a highlight and link to the archive/signup:

  • Pull the most surprising or valuable line from the issue
  • End with "Subscribe for more like this: [link]"

Growth Channel Reference

ChannelTacticExpected Conversion
WebsiteHomepage signup bar, exit intent popup, blog post CTAs1-3% of visitors
SocialPin newsletter link in bio, share issue highlights0.5-2% of followers
Cross-promoNewsletter swaps with similar-size newsletters50-200 subs per swap
Lead magnetFree resource into newsletter opt-in20-40% of landing page visitors
ReferralGive subscribers a referral link + incentive10-20% of new subs
ContentSEO articles with newsletter CTACompounding over time

Step 6: Engagement Metrics

MetricGoodGreatAction If Low
Open rate30-40%40-50%+Better subjects, clean list, check deliverability
Click rate2-4%5-8%+Better CTAs, more relevant links, clearer value
Reply rate1-2%3-5%+Ask better questions, be more personal
Unsubscribe<0.5%<0.2%Check frequency, relevance, expectations
Growth rate5-10%/mo10-20%/moAdd acquisition channels, improve lead magnets


Worked Example

Newsletter: "The Build Log" — Weekly hybrid newsletter for indie hackers

Subject Line Variants:

  1. "The feature that almost killed our conversion rate" (recommended)
  2. "Build Log #12: when metrics lie"
  3. "What I learned from a $0 week"

Preview Text: Plus 3 tools I switched to this month

Issue:

# The Build Log — Issue #12

## The feature that almost killed our conversion rate

Last week I shipped a "smart onboarding" flow. Took 3 days to build. Looked beautiful.

Conversion dropped 23%.

Turns out, users don't want smart. They want fast. The old flow was 2 steps. The new one was 5. Each step was better — but 5 steps is 5 chances to leave.

I reverted Thursday morning. Conversion recovered by Friday.

**The lesson:** Complexity is a tax. Every step you add needs to earn 10x what it costs in drop-off.

---

### 3 things worth your time

**[Why most MVPs are too big](link)** — This thread nails it. Your MVP should embarrass you, not impress your friends.

**[Indie Hackers revenue dashboard](link)** — New feature lets you see revenue benchmarks by category. I spent 30 minutes comparing and it was worth every second.

**[PostHog's session replay](link)** — Free tier is generous. Watching real users navigate your app is humbling and instructive.

---

### Tool I switched to

**Plausible Analytics** — Replaced Google Analytics. Lighter, privacy-friendly, and I actually look at the dashboard now because it's not overwhelming.

---

What's the last feature you shipped that backfired? Hit reply — I read everything.

— James

Output Structure

marketing/newsletter/
├── strategy.md                    # Newsletter definition and strategy
├── template.md                    # Repeatable issue template
├── growth-plan.md                 # Acquisition and referral strategy
└── issues/
    ├── 2026-03-12-issue-title.md  # Individual issues
    └── ...

Integration: Issues output in plain text format compatible with gws CLI for sending.

See references/archetype-templates.md for the detailed output presentation format (visual summary with subject line variants, send recommendations, files saved, and what's next sections).


References


Related Skills

  • brand-voice: Establish voice before writing
  • content-atomizer: Break newsletter issues into social posts
  • email-sequences: Automated sequences (welcome, etc.) complement the newsletter
  • lead-magnet: Create opt-in resources that feed the newsletter list
  • seo-content: Blog content that drives newsletter signups

Supporting file: references/archetype-templates.md

Newsletter Archetype Templates & Reference

Extracted from SKILL.md for token efficiency.


Format Templates

Format Templates

Template 1: Deep-Dive Framework Newsletter

SUBJECT LINE: [Specific question or problem] — [Hint at framework]

---

[PERSONAL OPENER - 2-3 sentences]
Brief personal context or why this topic is on your mind.

[THE QUESTION - Bold]
**[State the exact question you're answering]**

[CONTEXT - 1-2 paragraphs]
Why this matters. What's at stake. Who this is for.

---

## [FRAMEWORK NAME]

[Framework intro - 2-3 sentences explaining what it is]

### [Component 1]
[Explanation + example]

### [Component 2]
[Explanation + example]

### [Component 3]
[Explanation + example]

---

## How to Apply This

[Specific steps or implementation guidance]

1. [Step 1 with detail]
2. [Step 2 with detail]
3. [Step 3 with detail]

---

## Template / Checklist

[Downloadable or copy-paste resource]

---

## The Bottom Line

[2-3 sentence summary of key insight]

[SIGN-OFF]
[Your name]

P.S. [Personal note, question for readers, or CTA]

Example from Lenny Rachitsky:

"How do you make good decisions in situations where you lack perfect information? This question came from three different readers this month, so let me share the frameworks I actually use..."


Template 2: News Briefing Newsletter

SUBJECT LINE: [Day/Date]: [Hook about biggest story]

---

[LOGO/HEADER]

[ONE-LINE HOOK]
Today: [Teaser of what's inside]

---

## MARKETS
[Brief market data if relevant to your niche]
↑ [Metric 1] | ↓ [Metric 2] | → [Metric 3]

---

## TODAY'S TOP STORIES

### [STORY 1 HEADLINE - Intriguing, not straight news]

[2-3 sentence explanation of what happened]

**Why it matters:** [1-2 sentences on implications]

---

### [STORY 2 HEADLINE]

[2-3 sentence explanation]

**The bottom line:** [1 sentence takeaway]

---

### [STORY 3 HEADLINE]

[2-3 sentence explanation]

---

## QUICK HITS
• [One-liner news item 1]
• [One-liner news item 2]
• [One-liner news item 3]

---

## [SIGNATURE SECTION - Quiz, poll, or engagement hook]

[Question or interactive element]

---

[FOOTER with social links, referral program]

Morning Brew voice markers:

  • Humor in unexpected places
  • Pop culture references
  • Relatable analogies ("It's like if Netflix and your credit card had a baby...")
  • Bold the surprising part of each story

Template 3: Curated Links + Commentary

SUBJECT LINE: [Number] things worth your time: [Hook topic]

---

Hey [First Name] 👋

[1-2 sentence personal opener - what you've been thinking about]

Here's what caught my attention this week:

---

## 🔥 The Big One

**[Link Title](URL)**

[2-3 sentences on why this matters and your take]

---

## 📚 Worth Reading

**[Link 1 Title](URL)**
[1-2 sentence commentary]

**[Link 2 Title](URL)**
[1-2 sentence commentary]

**[Link 3 Title](URL)**
[1-2 sentence commentary]

---

## 🛠️ Tools & Resources

**[Tool Name](URL)** — [What it does + your opinion]

**[Tool Name](URL)** — [What it does + your opinion]

---

## 💭 One Thing I'm Thinking About

[Personal reflection or question - 2-3 sentences]

---

That's it for this week. Hit reply if anything resonated.

[Your name]

Ben's Bites voice markers:

  • Genuine enthusiasm (not performative)
  • "I found this and thought you'd like it" energy
  • Commentary adds value beyond the link
  • Organized by type (reading, tools, news)

Template 4: Personal Essay / Reflection

SUBJECT LINE: [Philosophical hook or contrarian take]

---

[OPENING HOOK - Story, observation, or provocative statement]
[2-4 sentences that create intrigue]

---

## [THE CORE IDEA]

[State your thesis clearly - 1-2 sentences]

[Expand on why you believe this - personal experience or observation]

---

## The Framework

[Present your mental model or framework]

**[Element 1]:** [Explanation]

**[Element 2]:** [Explanation]

**[Element 3]:** [Explanation]

---

## Questions to Ask Yourself

1. [Reflection question]
2. [Reflection question]
3. [Reflection question]

---

## The Takeaway

[1-2 sentence distillation of core insight]

[PERSONAL SIGN-OFF]
[Your name]

P.S. [Often includes a template download or resource]

Sahil Bloom voice markers:

  • Opens with philosophical hook or life observation
  • Frameworks have memorable names
  • Includes reflection questions for reader
  • Warm but substantive tone

Template 5: Builder/Startup Update

SUBJECT LINE: [Contrarian observation or "here's what I'm seeing"]

---

Look...

[Personal observation or realization that hooks - 2-3 sentences]

---

## The Idea

[Present a concept, framework, or trend you're seeing]

Here's what's working:

**[Pattern 1]** — [Real example with company name]

**[Pattern 2]** — [Real example with company name]

**[Pattern 3]** — [Real example with company name]

---

## Why This Matters Now

[Context on why timing matters - market shifts, technology changes, etc.]

---

## How to Think About This

[Your framework or mental model for the opportunity]

---

## What I'm Doing About It

[Personal application - your projects, investments, experiments]

---

If you're building in this space, I want to hear about it. Reply to this email.

[Your name]

---

📍 [Event or community plug]
🎙️ [Podcast or content plug]

Greg Isenberg voice markers:

  • "Look..." opener
  • Peer-to-peer energy, not guru
  • Real company examples, named
  • Building in public transparency
  • Community-focused CTAs

Template 6: Irreverent News + Story

SUBJECT LINE: [Unexpected angle on news + emoji]

---

[HOOK HEADLINE - Surprising juxtaposition or question]

[Opening anecdote that humanizes the story - 3-4 sentences]

---

**What happened:** [Factual summary in 2-3 sentences]

**Why it's weird:** [The angle that makes this interesting]

**The bigger picture:** [Business implication]

---

## Also Worth Knowing

**[Story 2 Headline]**
[Brief summary with personality]

**[Story 3 Headline]**
[Brief summary with personality]

---

## The Number of the Day

**[Surprising statistic]**

[1-2 sentence context on why it matters]

---

## One More Thing

[Lighter item, meme-worthy moment, or unexpected angle]

---

See you tomorrow,
[Editor nickname] 🦊

The Hustle voice markers:

  • Irreverent but not trying too hard
  • Headlines that create curiosity
  • "Why it's weird" — finds the surprising angle
  • Editor nicknames/personalities
  • Pop culture and meme fluency


Platform Guidance

Platform Guidance

Choosing the right newsletter platform matters. Each has strengths, limitations, and sweet spots. Here is an honest assessment to help users pick -- or optimize -- their platform.

Beehiiv

Best for:    Growth-focused creators and media companies
Pricing:     Free (up to 2,500 subs), Scale $39/mo, Max $99/mo
Strengths:
├── Built-in referral program (no third-party needed)
├── Ad network marketplace (monetize from day 1)
├── Website builder with SEO-friendly pages
├── Advanced segmentation and automations
├── Custom domains included on paid plans
├── Recommendation network for cross-growth
└── Analytics dashboard with revenue tracking

Limitations:
├── Newer platform (less third-party integration depth)
├── Templates less polished than Substack's defaults
├── Free plan has Beehiiv branding
└── Less community/social features than Substack

Best for:    Newsletters that want to become media businesses.
             If you care about growth tools, monetization
             options, and running a newsletter like a company,
             Beehiiv is the strongest choice.

Substack

Best for:    Writers and individual creators
Pricing:     Free (Substack takes 10% of paid sub revenue)
Strengths:
├── Zero upfront cost (pay only when you earn)
├── Built-in social network (Notes, recommendations)
├── Beautiful default design (no config needed)
├── Podcast and video hosting included
├── Discovery network drives organic subscribers
├── Paid subscriptions built in from day 1
└── Strong brand recognition ("I write on Substack")

Limitations:
├── 10% revenue cut on paid subscriptions
├── Limited design customization
├── No advanced automation or segmentation
├── You are building on their platform, not yours
├── No referral program built in
├── Limited A/B testing capabilities
└── Export is possible but migration is painful

Best for:    Solo writers who want simplicity. If you are
             building a personal essay, deep-dive, or opinion
             newsletter and value the built-in audience
             discovery, Substack is hard to beat. Not ideal
             if you want full control or advanced growth tools.

gws (now Kit)

Best for:    Creators selling digital products
Pricing:     Free (up to 10,000 subs), Creator $25/mo, Pro $50/mo
Strengths:
├── Best-in-class automation and tagging
├── Visual automation builder
├── Commerce features (sell digital products directly)
├── Landing page and form builder
├── Creator network for recommendations
├── Excellent deliverability reputation
└── Integrates with everything (Zapier, Stripe, etc.)

Limitations:
├── Newsletter design is basic/plain
├── No built-in ad marketplace
├── Analytics less detailed than Beehiiv
├── No referral program built in (need third-party)
├── Higher price per subscriber than competitors
└── Not optimized for media-style newsletters

Best for:    Creators who sell courses, ebooks, templates,
             or coaching. If your newsletter is the top
             of a funnel that leads to digital products,
             gws's commerce and automation features
             are unmatched. Less ideal for pure media plays.

Ghost

Best for:    Independent publishers who want full ownership
Pricing:     $9/mo (Starter), $25/mo (Creator), $50/mo (Team), or self-host free
Strengths:
├── Full ownership of your content and data
├── Beautiful, customizable themes
├── Built-in membership and paywall system
├── SEO-optimized website included
├── No platform revenue cut
├── Open source (self-host for free)
├── Native integrations with Stripe for payments
└── Publication-grade design out of the box

Limitations:
├── No built-in discovery or recommendation network
├── No referral program (need third-party)
├── Steeper learning curve than Substack
├── Self-hosting requires technical knowledge
├── Smaller ecosystem of integrations
├── No ad marketplace
└── Less growth-focused tooling

Best for:    Publishers who think long-term. If you want to
             own your platform, have publication-quality
             design, and are willing to drive your own growth
             rather than relying on platform discovery, Ghost
             is the most professional option. Ideal for
             established creators migrating off platforms.

Platform Selection Guide

Question                              Recommendation
─────────────────────────────────────────────────────
"I just want to write"               → Substack
"I want to grow fast"                → Beehiiv
"I sell digital products"            → gws
"I want full ownership"              → Ghost
"I need advanced automations"        → gws
"I want built-in monetization"       → Beehiiv or Substack
"I'm a solo writer, no tech skills"  → Substack
"I'm building a media company"       → Beehiiv
"I have an existing audience"        → Ghost or Beehiiv
"I want a recommendation network"    → Substack or Beehiiv

Platform-Specific Formatting Notes

When generating newsletter content, adjust formatting based on the user's platform:

  • Beehiiv: Full HTML support. Use custom headers, buttons, branded sections. Leverage their poll widget for engagement sections.
  • Substack: Keep it simple. Substack's renderer handles basic markdown well but complex HTML breaks. Use their built-in buttons for CTAs. Podcast embeds work natively.
  • gws: Plain text performs best on gws. Minimal HTML. Focus on the writing, not the design. Use their tag-based personalization for dynamic content.
  • Ghost: Full editorial design. Use their card system for images, callouts, bookmarks. Leverage members-only sections for paid content gating.


Growth & Monetization

Growth Strategy

Getting subscribers is not about going viral. It is about building consistent, compounding growth through multiple channels that reinforce each other.

Referral Programs

The single highest-leverage growth tactic for newsletters. Turns every reader into a distribution channel.

How to structure referral rewards:

Tier 1 (1 referral):     Digital reward
├── Exclusive article or template
├── Access to a resource library
└── "Founding reader" badge

Tier 2 (3-5 referrals):  Community access
├── Private Slack/Discord channel
├── Monthly AMA or Q&A session
└── Early access to new content

Tier 3 (10+ referrals):  Tangible reward
├── Physical merchandise (stickers, shirt)
├── Free month of paid subscription
├── 1:1 consultation or feedback session
└── Featured mention in the newsletter

Tier 4 (25+ referrals):  Premium reward
├── Free annual subscription
├── Co-creation opportunity (guest write)
├── Access to private mastermind
└── Physical gift (book, branded item)

Referral program best practices:

  • Make sharing frictionless (one-click share link)
  • Show progress toward next reward tier
  • Reward the referrer, not just the referee
  • Use rewards that match your audience's identity (Morning Brew's joggers worked because their audience is young professionals)
  • Avoid generic rewards (Amazon gift cards feel transactional)
  • Place the referral CTA at the end of your best content (when satisfaction is highest)

Cross-Promotions

Partner with newsletters of similar size and complementary (not competing) audiences.

Finding cross-promotion partners:

  1. Search for newsletters in adjacent niches (you cover marketing, they cover sales)
  2. Look for newsletters with similar subscriber counts (within 2x of your size)
  3. Check newsletter directories: Beehiiv's recommendation network, Substack's recommendations, Letterlist, Newsletter Stack
  4. Reach out to writers you already read and cite

Cross-promotion formats:

  • Swap mentions: You mention their newsletter, they mention yours. Lowest friction.
  • Co-authored edition: Write a joint edition together. Highest impact.
  • Guest spotlight: Feature each other as guest contributors for one edition.
  • Shared resource: Create a co-branded lead magnet and share the email list.
  • Recommendation page: Add each other to your "newsletters I recommend" page.

Template for outreach:

Subject: Cross-promo idea — [Your Newsletter] x [Their Newsletter]

Hey [Name],

I run [Your Newsletter] ([subscriber count] subscribers,
[niche]). I've been reading your work on [specific topic]
and think our audiences would genuinely benefit from
knowing about each other.

Quick idea: mutual recommendation in our next editions.
I'd write a genuine 2-3 sentence recommendation of your
newsletter, and you'd do the same for mine.

No strings. If it doesn't feel right, no worries at all.

[Your name]
[Link to your newsletter]

Lead Magnet Integration

Use your newsletter as the distribution vehicle for lead magnets -- and use lead magnets as the signup incentive for the newsletter.

Newsletter-to-lead-magnet flow:

  1. Write a newsletter edition about a topic
  2. Create a deeper resource on that topic (checklist, template, guide)
  3. Offer the resource in the newsletter as a bonus: "Want the full checklist? Grab it here."
  4. The resource signup page also subscribes them to the newsletter (if they are not already)

Lead-magnet-to-newsletter flow:

  1. Create a lead magnet that solves a specific problem
  2. Deliver the lead magnet via email
  3. The delivery email welcomes them to the newsletter
  4. The first 3 newsletter editions reinforce the lead magnet's topic
  5. Subscribers stay because the newsletter delivers ongoing value, not just the one-time freebie

Connection to /lead-magnet skill: If the user has already run /lead-magnet, reference the existing asset. If not, suggest running it: "A lead magnet would give you a subscriber acquisition engine. Run /lead-magnet to create one."

Social Proof Tactics

Build credibility signals that make subscribing feel like the obvious choice.

Subscriber milestones:

  • Celebrate round numbers publicly (1,000 / 5,000 / 10,000)
  • Frame growth in terms of community, not vanity metrics: "10,000 marketers now read this every Tuesday"
  • Use milestones as content hooks: "What I learned growing to 5K subscribers"

Testimonial collection:

  • After every edition that gets positive replies, ask: "Mind if I quote that on my signup page?"
  • Screenshot and archive positive replies for social proof
  • Curate "what readers are saying" for your landing page and social bios

Authority signals:

  • Open rate statistics (if above average): "45% average open rate" signals quality
  • Notable subscribers or companies (with permission): "Read by teams at [Company]"
  • Media mentions or citations: "Featured in [Publication]"
  • Subscriber growth rate: "Growing 15% month-over-month"

Growth Channel Matrix

Channel               Effort   Timeline    Impact
──────────────────────────────────────────────────
Referral program      Medium   Ongoing     High
Cross-promotions      Low      1-2 weeks   Medium
Social media clips    Medium   Ongoing     Medium
SEO (blog repurpose)  High     3-6 months  High
Podcast appearances   Medium   2-4 weeks   Medium
Lead magnets          Medium   1-2 weeks   High
Paid ads              High     Immediate   Variable
Community presence    Low      Ongoing     Low-Med
Guest writing         High     2-4 weeks   Medium
Product Hunt launch   Low      One-time    Variable

Monetization Framework

Newsletters can generate revenue through four primary models. Most successful newsletters combine two or more.

Model 1: Sponsorships

The most common monetization path. Sell placements within your newsletter.

Sponsorship placement types:

Placement          Description                CPM Range
──────────────────────────────────────────────────────────
Primary sponsor    Top of newsletter, logo,   $25-75
                   2-3 sentences
Mid-roll           Between sections,          $15-40
                   1-2 sentences
Classified         Bottom section, one-       $5-15
                   liner with link
Dedicated email    Entire edition about       $50-150+
                   the sponsor's topic

Pricing your sponsorship:

Formula: Subscriber count x CPM / 1,000

Example:
├── 10,000 subscribers
├── $40 CPM (mid-range for engaged niche)
├── Primary sponsor: $400 per edition
├── 4 editions/month = $1,600/month potential
└── Annual: ~$19,200

CPM benchmarks by niche:
├── General business:    $15-30
├── Tech/SaaS:           $30-60
├── Finance/investing:   $40-80
├── Marketing:           $25-50
├── AI/emerging tech:    $35-70
├── Developer tools:     $30-65
└── Creator economy:     $20-45

Sponsorship best practices:

  • Only accept sponsors your audience would actually use
  • Write the ad copy yourself to match your voice (native integration)
  • Label sponsorships clearly ("Today's edition is brought to you by...")
  • Limit to 1-2 sponsors per edition (more dilutes trust)
  • Negotiate quarterly or annual deals for rate stability
  • Track click-through rates and share them with sponsors
  • Build a sponsorship page with audience demographics, open rates, and testimonials

Model 2: Paid Subscriptions

Offer a premium tier with additional content, access, or community.

Free vs paid content architecture:

Free tier (acquire + retain):
├── Core newsletter edition
├── Frameworks and key insights
├── News coverage and curation
└── Enough value to share and grow

Paid tier ($5-30/month):
├── Deep-dive extras (extended analysis)
├── Templates, checklists, resources
├── Archive access (all past editions)
├── Community access (Slack/Discord)
├── Monthly AMA or office hours
├── Early access to new content
└── Ad-free reading experience

Paid tier pricing strategy:

  • $5-10/month: Low barrier, volume play. Best for broad audiences.
  • $10-20/month: Mid-range. Best for professional/business audiences.
  • $20-30/month: Premium. Needs high-value content (data, research, tools).
  • Annual discount: Offer 20-30% off annual to reduce churn.

Conversion benchmarks:

  • Free-to-paid conversion: 2-5% is good, 5-10% is excellent
  • Monthly churn target: under 5%
  • Annual subscriber retention: 70%+ is strong

Model 3: Native Ad Integration

Write about sponsors' products in your own voice, as part of the editorial content.

Native ad principles:

  • Must be genuinely useful to your audience (not just highest bidder)
  • Clearly labeled but not jarring (subtle disclosure)
  • Written in your voice, not the sponsor's marketing copy
  • Include your honest take, not just talking points
  • Test the product yourself before writing about it

Native ad format example:

## Tool I've Been Using

[Sponsor Name] — [One-line description]

I've been testing [product] for [timeframe] and
here's what I found: [honest assessment].

The feature that surprised me: [specific feature].

If you're dealing with [problem it solves], it's
worth a look. [Affiliate or tracked link]

[Disclosure: This section is sponsored by
[Sponsor]. All opinions are mine.]

Model 4: Product/Course Funnel

Use the newsletter as the top-of-funnel for your own products.

Newsletter-to-product funnel:

Stage 1: Free newsletter (build trust)
    ↓
Stage 2: Lead magnet (demonstrate expertise)
    ↓
Stage 3: Low-ticket product ($27-97)
    ↓
Stage 4: Core product/course ($197-997)
    ↓
Stage 5: Premium offer ($1,000+)

Integration rules:

  • Never make the newsletter feel like a sales funnel
  • Ratio: 80% value / 20% promotion maximum
  • Promote products through case studies and results, not pitches
  • Use the P.S. section for soft product mentions
  • Hard sell only in dedicated launch sequences (separate from regular editions)

Revenue Milestone Framework

Subscribers   Primary Revenue        Monthly Target
──────────────────────────────────────────────────────
0-1,000       Product funnel         $0-500
1,000-5,000   Sponsorships + product $500-2,500
5,000-10,000  Sponsorships + paid    $2,500-7,500
10,000-25,000 Multi-model            $7,500-25,000
25,000-50,000 Media business         $25,000-75,000
50,000+       Full media company     $75,000+


Best-in-Class Examples

Best-in-Class Examples to Study

NewsletterTypeWhat to Learn
Lenny RachitskyDeep-DiveFramework presentation, credibility anchoring
Morning BrewNews BriefingVoice, scannability, referral program
Ben's BitesCurated + CommentaryCuration that adds value
Sahil BloomPersonal EssayReflection frameworks, templates
Greg IsenbergBuilder UpdatesPeer energy, real examples
The HustleIrreverent NewsPersonality, unexpected angles
FinimizeFinancial Briefing"Key takeaways" format
The Rundown AIAI NewsBusiness implications framing
boringmarketerMarketingContrarian takes, systems thinking

See references/newsletter-examples.md for detailed breakdowns of each newsletter's structure, voice markers, and sample formats.



Output Format Reference

Output Format

The execution flow is defined in SKILL.md (Steps 1-6). This section defines the OUTPUT FORMAT to use when presenting the finished newsletter.

When presenting the finished newsletter, use this structure:

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

  NEWSLETTER EDITION
  Generated {date}

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

  TYPE: {archetype name}
  TOPIC: {topic}

  ──────────────────────────────────────────────

  SUBJECT LINE VARIANTS

  ① "{variant 1}"                    ★ recommended
     → Strength: {why this works}

  ② "{variant 2}"
     → Strength: {why this works}

  ③ "{variant 3}"
     → Strength: {why this works}

  Recommended A/B test: ① vs ②

  ──────────────────────────────────────────────

  NEWSLETTER CONTENT

  {Full newsletter body here, formatted per
  the chosen archetype template}

  ──────────────────────────────────────────────

  SEND RECOMMENDATIONS

  Best time:  {day}, {time} {timezone}
  A/B test:   Subject lines ① vs ②
  Segment:    {if applicable}

  ──────────────────────────────────────────────

  SOURCES

  {List of sources with links, if web search
  was used}

  ──────────────────────────────────────────────

  FILES SAVED

  ./campaigns/newsletters/{file}.md    ✓ (new)
  ./brand/assets.md                    ✓ (1 entry added)

  WHAT'S NEXT

  Your newsletter edition is ready. Before sending:

  → /creative           Build it — HTML template,
                        header design, or visual
                        assets (~15 min)
  → "Skip visuals"      Continue to distribution ↓

  ──────────────────────────────────────────────

  → /content-atomizer   Atomize for social (~10 min)
  → /email-sequences    Build subscriber welcome
                        sequence (~15 min)
  → "Iterate"           Revise sections or subject
  → "Different format"  Try another archetype
  → "Send tips"         Platform-specific send advice

  Or tell me what you're working on and I'll
  route you.

Supporting file: references/newsletter-examples.md

Newsletter Examples & Patterns

Detailed breakdowns of what makes top newsletters work. Study these, then adapt for your voice.


Lenny Rachitsky — The Framework Newsletter

Stats: 1M+ subscribers, $15/month paid tier Frequency: Weekly (free), 2x weekly (paid) Niche: Product management, growth, startups

What Makes It Work

1. Credibility Anchoring Lenny doesn't claim to invent everything. He credits sources:

"This framework came from my time at Airbnb, developed with [specific colleague]..."

This makes him more trustworthy, not less.

2. The Q&A Format Many editions answer reader questions directly. Creates:

  • Proof of engaged audience
  • Content that addresses real problems
  • Variety in topics

3. Framework + Template Every framework includes implementation guidance:

"Here's the RAT Decision Framework. And here's the exact template we used."

Readers can apply it immediately.

4. Free vs Paid Architecture Free: Frameworks and insights Paid: Deep dives, archives, podcast content

Taste → Want more → Pay

Sample Structure

[Personal opener - 2 sentences]

Q: [Reader question in their words]

A: [Lenny's response - builds framework]

## The [Name] Framework

[Explanation]

### When to Use It
[Guidance]

### Template
[Downloadable resource]

## Other Frameworks to Consider
[Brief alternatives]

---

That's it for this week.

[Sign-off]
Lenny

Voice Markers

  • "I've seen this work at Airbnb, Notion, and Stripe..."
  • "The honest answer is..."
  • Credits others liberally
  • Admits what he doesn't know

Morning Brew — The Daily Briefing

Stats: 5M+ subscribers Frequency: Daily Niche: Business news for young professionals

What Makes It Work

1. The 22% Humor Rule ~22% of jokes require business literacy (inside jokes for regulars) ~78% are universally relatable (accessible to new readers)

This balance builds community without alienating newcomers.

2. Markets Section First Opens with what readers expect: market data. Delivers utility immediately.

3. Intentional Bolding Only bold the most surprising or important detail in each story. If everything is bold, nothing is.

4. Referral Program Design Rewards match audience preferences:

  • Laptop stickers (work from home)
  • Joggers (casual dress)
  • Merchandise that signals belonging

Not generic Amazon gift cards.

Sample Structure

[LOGO]

MARKETS
S&P: ↑2.1% | Nasdaq: ↑1.8% | BTC: ↓3.2%

---

BUSINESS

[Intriguing headline, not straight news]

[2-3 sentences on what happened]

**The bottom line:** [1 sentence takeaway]

---

[Second story - same format]

---

QUICK HITS
• [One-liner]
• [One-liner]
• [One-liner]

---

GAMES
[Trivia or interactive element]

Voice Markers

  • Pop culture references in unexpected places
  • "It's like if [relatable thing] and [other thing] had a baby"
  • Emoji use is restrained but purposeful
  • Self-aware about being a business newsletter

Sample Opening:

"Tesla's having a moment. And not the good kind of moment like when you nail parallel parking on the first try."


Ben's Bites — The Curated Commentary

Stats: 140K+ subscribers Frequency: Daily Niche: AI news and tools

What Makes It Work

1. Curation That Adds Value Every link includes Ben's take on why it matters. Not just "check this out" but "check this out because..."

2. Three Content Types

  • News summaries (time-sensitive)
  • Hand-picked articles (evergreen)
  • Tool showcases (practical)

Variety keeps it interesting.

3. The AI Project Tracker Created a database of every link ever curated. Became a referral incentive AND a product.

4. Enthusiasm Without Hype Genuinely excited about AI without the "EVERYTHING IS CHANGING" panic energy.

Sample Structure

Hey friends 👋

[1-2 sentence personal opener]

---

## 🔥 Today's top story

[Headline + link]

[3-4 sentences on what it is and why it matters]

My take: [1-2 sentences of opinion]

---

## 🗞️ News

• [One-liner + link]
• [One-liner + link]
• [One-liner + link]

---

## 🛠️ Cool tools

[Tool name + link] — [What it does, my opinion]

---

See you tomorrow!
Ben

Voice Markers

  • "This is cool because..."
  • "I'm skeptical about X but..."
  • "Found this and immediately thought of you all"
  • Friendly, not performative

Sahil Bloom — The Reflection Newsletter

Stats: 700K+ subscribers Frequency: Weekly Niche: Personal development, life frameworks

What Makes It Work

1. Themed Editions Each newsletter has a coherent theme, not random assortment:

  • The Annual Review
  • The Wealth Score
  • Winner's Game vs Loser's Game

2. Reflection Questions Every framework includes questions for self-application:

"Ask yourself: What did I not do this year because of fear?"

Transforms passive reading into active reflection.

3. Templates and Tools Frameworks come with implementation resources:

  • Downloadable PDFs
  • Quizzes
  • Checklists

4. The Wealth Score Concept Redefined "wealth" across 5 dimensions. Original framework that became signature IP.

Sample Structure

[Hook - philosophical observation]

---

## The [Framework Name]

[What it is - 2-3 sentences]

### [Dimension 1]
[Explanation + why it matters]

### [Dimension 2]
[Explanation + why it matters]

### [Dimension 3]
[Explanation + why it matters]

---

## Questions to Ask

1. [Reflection question]
2. [Reflection question]
3. [Reflection question]

---

## The Takeaway

[Core insight distilled]

---

[Warm sign-off]
Sahil

P.S. [Template or resource link]

Voice Markers

  • Opens with philosophical observation
  • "A failure to X will eventually result in Y"
  • Uses "you" directly and personally
  • Warm but not saccharine

Greg Isenberg — The Builder Newsletter

Stats: 150K+ subscribers Frequency: Weekly Niche: Startups, community, internet business

What Makes It Work

1. The "Look..." Opener Conversational, peer-to-peer energy from the first word.

2. Real Company Examples Every concept includes specific, named examples:

"Audible's Shared Clips feature does this perfectly..." "Notion's template universe is engineered for this..."

Not abstract. Concrete.

3. Building in Public Shares what he's actually doing—investments, projects, experiments. Skin in the game.

4. Community-First CTAs Calls to action aren't "buy my course" but "come to my event" or "join the community."

Sample Structure

Look...

[Personal observation or realization - 2-3 sentences]

---

## Here's what I'm seeing

[Trend or pattern]

**Example 1:** [Company name] does this by [specific mechanism]

**Example 2:** [Company name] does this by [specific mechanism]

---

## Why now?

[Context on timing and opportunity]

---

## What I'm doing about it

[Personal application or investment]

---

If you're building in this space, hit reply. Serious.

Greg

---

📍 [Event plug]
🎙️ [Podcast plug]

Voice Markers

  • "Look..." opener
  • "Here's what's actually happening..."
  • Names names (companies, people)
  • "Serious." as emphasis
  • Casual punctuation (dashes, ellipses)

The Hustle — The Irreverent News

Stats: 2.5M+ subscribers Frequency: Daily Niche: Business news with personality

What Makes It Work

1. Unexpected Angles Not "Company raises $50M" but "Why this $50M raise means your coffee is about to get weird"

2. The Editor Personality Each edition ends with an editor nickname. Creates human connection and encourages reading to the end.

3. Anecdote-First Structure Opens with human-scale story before zooming out to business implications.

4. "Why it's weird" Every story answers: why should you care? What's the surprising angle?

Sample Structure

[UNEXPECTED HEADLINE]

[Opening anecdote - humanizes the story]

---

**What happened:** [Factual summary]

**Why it's weird:** [The angle]

**The bigger picture:** [Business implication]

---

## Also this happened

[Story 2 - same structure, shorter]

---

## The number

**$4.7 billion**

That's how much [context for surprising stat]

---

Later nerds 🤓
[Editor nickname]

Voice Markers

  • Headlines that make you curious
  • "Here's the thing..."
  • Self-aware humor
  • "Later nerds" / personality in sign-offs
  • Knows when to be serious (doesn't joke about everything)

The Rundown AI — The Applied News

Stats: 600K+ subscribers Frequency: Daily Niche: AI news with business application

What Makes It Work

1. "Why it matters to you" Every story includes explicit business application:

"Why it matters: If you're building [X], this means [Y]"

2. The 5-Minute Promise Explicitly positioned as "everything you need in 5 minutes." Respects reader time.

3. Tools Section Practical "here's what you can use today" separate from news.

4. Business-First Framing Not "cool AI thing" but "how this AI thing affects your work/business."

Sample Structure

Today in AI: [One-line hook]

---

## 🚀 Top Story

[Headline]

[What happened - 2-3 sentences]

**Why it matters:** [Business application]

**PLUS:** [Related tool or secondary angle]

---

## 📰 Quick Hits

• [Story + implication]
• [Story + implication]
• [Story + implication]

---

## 🛠️ Tool of the Day

[Name] — [What it does + who it's for]

---

That's it for today. Forward to someone who needs to know.

Voice Markers

  • Always connects to "what you can do with this"
  • No hype, just facts + implications
  • "Forward to someone..." CTA

Patterns Across All Great Newsletters

1. Consistent Format

Readers know what to expect. Sections are predictable. Navigation is easy.

2. Distinct Voice

You could identify the newsletter from a random paragraph. Not generic, not corporate.

3. Clear Value Proposition

Each type delivers something specific:

  • Lenny: Frameworks you can use
  • Morning Brew: 5-minute business update
  • Ben's Bites: AI curation you can trust
  • Sahil: Life improvement through reflection
  • Greg: Ideas from the building trenches
  • The Hustle: Business news that doesn't bore you

4. Respect for Reader Time

  • Above-fold content earns continued reading
  • Scannability for busy readers
  • Clear sections for different consumption modes

5. Human Moments

  • Personal openers
  • Admits uncertainty
  • Shows personality
  • Signs off with a name, not a brand

Quick Reference: Which Format for Your Goals?

GoalFormatExample
Build authorityDeep-Dive FrameworkLenny Rachitsky
Daily habitNews BriefingMorning Brew
Niche curatorCurated + CommentaryBen's Bites
Personal brandEssay/ReflectionSahil Bloom
Founder audienceBuilder UpdatesGreg Isenberg
Broad audienceIrreverent NewsThe Hustle
Fast-moving spaceApplied NewsThe Rundown AI

Supporting file: brand/audience.md

Audience

Primary ICP

Solo founders and agent builders shipping products with Claude Code / Cursor / Codex who need marketing that compounds instead of one-off ChatGPT threads.

Jobs to be done

  • "My agent forgets our brand every session"
  • "I need consistent launch/SEO/social output without hiring a CMO"
  • "I want skills my agent can actually run, not blog posts about marketing"

Watering holes

  • Twitter/X (AI builders, indie hackers)
  • Hacker News (Show HN, agent tooling threads)
  • GitHub (README-driven discovery)
  • Discord/Slack communities around Claude Code / Cursor

Messaging angles

  • Compounding brand memory
  • One install, agent-ready
  • CLI for the agent, Studio for the human

Supporting file: brand/voice-profile.md

Voice Profile

Personality

  • Direct, product-obsessed, builder-friendly
  • Confident without hype; allergic to growth-hack theatrics
  • Speaks to agents and the humans who steer them

Tone

  • Clear and concrete
  • Short sentences when instructing agents; slightly warmer for human landing copy
  • Prefer proof (commands, counts, benches) over adjectives

Vocabulary

  • Prefer: ship, compound, playbook, agent-native, dry-run, brand memory, orchestrate
  • Avoid: synergy, leverage, disrupt, 10x your, unlock growth, revolutionary

Example lines

  • "Install one CLI. Your agent gets 64 skills, 6 research agents, and brand memory that compounds."
  • "CLI for the agent. Studio for the human."
  • "Skills work at zero context. Brand memory makes them sharper — never a gate."

How do I install Newsletter system in Cursor, Claude Code, or Codex?

Run npx skills add moizibnyousaf/marketing-cli --skill newsletter in the project where you want it, then ask your agent for the skill by name. The --skill flag installs only Newsletter system, not every skill in the repository.

Where does Newsletter system come from and what license is it under?

Newsletter system comes from the moizibnyousaf/marketing-cli repository on GitHub. That repository has 30 GitHub stars. The skill is published under the MIT license.

Prefer plain text? Read the Newsletter system guide as markdown.