$npx -y skills add MoizIbnYousaf/marketing-cli --skill newsletterDesign, write, and grow editorial newsletters with consistent voice and format. Creates newsletter strategy, templates, and growth playbook. Use when someone wants to start a newsletter, improve an existing one, grow subscribers, write a newsletter issue, plan newsletter content,
| 1 | # Newsletter System |
| 2 | |
| 3 | 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. |
| 4 | |
| 5 | ## On Activation |
| 6 | |
| 7 | 1. Read `brand/voice-profile.md` — newsletters live or die by voice consistency |
| 8 | 2. Read `brand/audience.md` — understand what they care about, how sophisticated they are |
| 9 | 3. If starting fresh, ask: What's the newsletter about? Who's it for? What format appeals to you? |
| 10 | 4. Check `marketing/newsletter/` for existing strategy and past issues |
| 11 | |
| 12 | --- |
| 13 | |
| 14 | ## Brand Integration |
| 15 | |
| 16 | - **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. |
| 17 | - **audience.md** → Content selection and depth matches audience sophistication. Technical audience gets deep dives. General audience gets accessible summaries with links to learn more. |
| 18 | |
| 19 | --- |
| 20 | |
| 21 | ## Step 1: Define the Newsletter |
| 22 | |
| 23 | ### Newsletter Types |
| 24 | |
| 25 | | Type | Description | Best For | Example | |
| 26 | |------|-------------|----------|---------| |
| 27 | | **Curated** | Best links + your commentary | Industry watchers, busy professionals | The Hustle, TLDR | |
| 28 | | **Editorial** | Original essays/insights | Thought leaders, opinionated founders | Stratechery, Lenny's Newsletter | |
| 29 | | **Hybrid** | Mix of original + curated | Most founders and creators | Morning Brew, Dense Discovery | |
| 30 | | **Product update** | What's new in your product | SaaS companies with active users | Linear, Notion changelogs | |
| 31 | | **Educational** | Teaches one skill per issue | Course creators, consultants | James Clear, Marketing Examples | |
| 32 | |
| 33 | ### Strategy Doc |
| 34 | |
| 35 | Before writing a single issue, establish: |
| 36 | |
| 37 | ```yaml |
| 38 | --- |
| 39 | name: "Newsletter Name" |
| 40 | tagline: "One-line value prop (what they get + how often)" |
| 41 | type: curated | editorial | hybrid | product | educational |
| 42 | frequency: weekly | biweekly | daily |
| 43 | send_day: Tuesday |
| 44 | send_time: "9:00 AM ET" |
| 45 | target_audience: "Who specifically reads this" |
| 46 | core_topic: "The single topic area" |
| 47 | voice: "How it sounds (reference voice-profile.md)" |
| 48 | success_metric: "Open rate > 40%, click rate > 5%" |
| 49 | --- |
| 50 | ``` |
| 51 | |
| 52 | --- |
| 53 | |
| 54 | ## Step 2: Build the Template |
| 55 | |
| 56 | Every newsletter needs a repeatable structure readers come to expect. |
| 57 | |
| 58 | ### Template Structure |
| 59 | |
| 60 | ```markdown |
| 61 | # [Newsletter Name] — Issue #[N] |
| 62 | |
| 63 | ## [Catchy issue title or theme] |
| 64 | |
| 65 | ### Intro (2-3 sentences) |
| 66 | [Personal hook — what happened this week, what's on your mind, why this issue matters] |
| 67 | |
| 68 | --- |
| 69 | |
| 70 | ### Section 1: [Main Value Block] |
| 71 | [The core content — original insight, deep dive, or primary curation] |
| 72 | |
| 73 | ### Section 2: [Secondary Value] |
| 74 | [Supporting content, related links, or complementary angle] |
| 75 | |
| 76 | ### Section 3: [Quick Hits / Links] |
| 77 | - **[Link title]** — One-line commentary on why it matters |
| 78 | - **[Link title]** — One-line commentary |
| 79 | - **[Link title]** — One-line commentary |
| 80 | |
| 81 | --- |
| 82 | |
| 83 | ### [Recurring Section Name] |
| 84 | [Something predictable readers look forward to: tool of the week, quote, stat, hot take] |
| 85 | |
| 86 | --- |
| 87 | |
| 88 | ### CTA |
| 89 | [One primary ask: share, reply, check out product, visit link] |
| 90 | |
| 91 | --- |
| 92 | |
| 93 | [Sign-off in your voice] |
| 94 | [Name] |
| 95 | |
| 96 | [Footer: unsubscribe, share link, social links] |
| 97 | ``` |
| 98 | |
| 99 | ### Format-Specific Templates |
| 100 | |
| 101 | **Curated Newsletter:** |
| 102 | - 5-7 links with 2-3 sentence commentary each |
| 103 | - Group by theme or rank by importance |
| 104 | - Your opinion is the value — don't just summarize |
| 105 | |
| 106 | **Editorial Newsletter:** |
| 107 | - One main essay (500-1,000 words) |
| 108 | - Strong opening hook |
| 109 | - Clear argument or insight |
| 110 | - End with a question or call to reply |
| 111 | |
| 112 | **Hybrid Newsletter:** |
| 113 | - One short original piece (300-500 words) |
| 114 | - 3-5 curated links with commentary |
| 115 | - One recurring s |