Newsletter system
Quick answer
- 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.
Add this skill
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.
$ npx skills add moizibnyousaf/marketing-cli --skill newsletterSkill instructions
The instruction file for this skill. The skill also includes other files you need to install to use it.
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
- Read
brand/voice-profile.md— newsletters live or die by voice consistency - Read
brand/audience.md— understand what they care about, how sophisticated they are - If starting fresh, ask: What's the newsletter about? Who's it for? What format appeals to you?
- 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
| Type | Description | Best For | Example |
|---|---|---|---|
| Curated | Best links + your commentary | Industry watchers, busy professionals | The Hustle, TLDR |
| Editorial | Original essays/insights | Thought leaders, opinionated founders | Stratechery, Lenny's Newsletter |
| Hybrid | Mix of original + curated | Most founders and creators | Morning Brew, Dense Discovery |
| Product update | What's new in your product | SaaS companies with active users | Linear, Notion changelogs |
| Educational | Teaches one skill per issue | Course creators, consultants | James 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
- Choose the theme: One core topic per issue. No scatter.
- Write the hook: First 2 sentences determine if they read or archive. Make it personal, specific, or surprising.
- Deliver the value: The thing they subscribed for. Don't bury it.
- Keep sections scannable: Bold key phrases. Short paragraphs. Clear headers.
- 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
| Frequency | Pros | Cons | Best For |
|---|---|---|---|
| Daily | Habit-forming, high engagement | Burnout risk, high content demand | News, curation-heavy |
| Weekly | Sustainable, high quality per issue | Slower growth | Most creators and businesses |
| Biweekly | Low pressure, high quality | Harder to build habit | In-depth analysis, B2B |
| Monthly | Maximum quality | Easy to forget about | Reports, 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
| Channel | Tactic | Expected Conversion |
|---|---|---|
| Website | Homepage signup bar, exit intent popup, blog post CTAs | 1-3% of visitors |
| Social | Pin newsletter link in bio, share issue highlights | 0.5-2% of followers |
| Cross-promo | Newsletter swaps with similar-size newsletters | 50-200 subs per swap |
| Lead magnet | Free resource into newsletter opt-in | 20-40% of landing page visitors |
| Referral | Give subscribers a referral link + incentive | 10-20% of new subs |
| Content | SEO articles with newsletter CTA | Compounding over time |
Step 6: Engagement Metrics
| Metric | Good | Great | Action If Low |
|---|---|---|---|
| Open rate | 30-40% | 40-50%+ | Better subjects, clean list, check deliverability |
| Click rate | 2-4% | 5-8%+ | Better CTAs, more relevant links, clearer value |
| Reply rate | 1-2% | 3-5%+ | Ask better questions, be more personal |
| Unsubscribe | <0.5% | <0.2% | Check frequency, relevance, expectations |
| Growth rate | 5-10%/mo | 10-20%/mo | Add acquisition channels, improve lead magnets |
Worked Example
Newsletter: "The Build Log" — Weekly hybrid newsletter for indie hackers
Subject Line Variants:
- "The feature that almost killed our conversion rate" (recommended)
- "Build Log #12: when metrics lie"
- "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
- newsletter-examples.md (references/newsletter-examples.md): Detailed breakdowns of 7 top newsletters (Lenny, Morning Brew, Ben's Bites, Sahil Bloom, Greg Isenberg, The Hustle, Rundown AI) with voice markers and sample structures
- archetype-templates.md (references/archetype-templates.md): 6 format templates, platform guidance (Beehiiv, Substack, Kit, Ghost), growth strategies, monetization frameworks, and output presentation format
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:
- Search for newsletters in adjacent niches (you cover marketing, they cover sales)
- Look for newsletters with similar subscriber counts (within 2x of your size)
- Check newsletter directories: Beehiiv's recommendation network, Substack's recommendations, Letterlist, Newsletter Stack
- 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:
- Write a newsletter edition about a topic
- Create a deeper resource on that topic (checklist, template, guide)
- Offer the resource in the newsletter as a bonus: "Want the full checklist? Grab it here."
- The resource signup page also subscribes them to the newsletter (if they are not already)
Lead-magnet-to-newsletter flow:
- Create a lead magnet that solves a specific problem
- Deliver the lead magnet via email
- The delivery email welcomes them to the newsletter
- The first 3 newsletter editions reinforce the lead magnet's topic
- 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
| Newsletter | Type | What to Learn |
|---|---|---|
| Lenny Rachitsky | Deep-Dive | Framework presentation, credibility anchoring |
| Morning Brew | News Briefing | Voice, scannability, referral program |
| Ben's Bites | Curated + Commentary | Curation that adds value |
| Sahil Bloom | Personal Essay | Reflection frameworks, templates |
| Greg Isenberg | Builder Updates | Peer energy, real examples |
| The Hustle | Irreverent News | Personality, unexpected angles |
| Finimize | Financial Briefing | "Key takeaways" format |
| The Rundown AI | AI News | Business implications framing |
| boringmarketer | Marketing | Contrarian 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?
| Goal | Format | Example |
|---|---|---|
| Build authority | Deep-Dive Framework | Lenny Rachitsky |
| Daily habit | News Briefing | Morning Brew |
| Niche curator | Curated + Commentary | Ben's Bites |
| Personal brand | Essay/Reflection | Sahil Bloom |
| Founder audience | Builder Updates | Greg Isenberg |
| Broad audience | Irreverent News | The Hustle |
| Fast-moving space | Applied News | The 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."
Common questions
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.