Newsletter Writer
SkillAI & modelsThe open-source company brain. Run your entire company with AI agents, skills, and a self-improving context.
Available today. Use it from your connected AI after setup.
No other account needed.
Connect ahel once, and every AI you use reads what you have installed.
Then ask your AI: use the Newsletter Writer skill
What this skill tells your AI
The instructions your AI receives, as published by getnao/sylph in .claude/skills/newsletter/SKILL.md and read by ahel’s review.
name: newsletter-writer
description: >
Writes short-form email newsletters. Optimized for open rates,
click-throughs, and subscriber retention.
triggers:
- newsletter
- email newsletter
- weekly update email
MCP connectors
| Connector | Purpose |
|---|---|
| Email platform | Send newsletter (e.g., Mailchimp, Substack, ConvertKit) |
What Works
- Short. 200-400 words max for the main content. Readers skim email.
- Hook-first. The first sentence after the subject line determines if they keep reading.
- One CTA. Every newsletter has exactly one primary call-to-action. Don't split attention.
- Consistent structure. Readers should know what to expect each time.
- Personal tone. Write like you're emailing one person, not broadcasting to thousands.
- Value upfront. The best newsletters give the takeaway in the email, not behind a click.
What Doesn't Work
- Long intros before getting to the point
- Multiple CTAs competing for attention
- Generic "this week in [industry]" roundups with no POV
- Formal language ("Dear subscriber")
- Walls of text without formatting
Subject Line Discipline
The subject line is the most important line. Rules:
- Under 50 characters (renders fully on mobile)
- Specific over clever. "3 things that broke our pipeline" beats "Newsletter #47"
- No ALL CAPS or excessive punctuation
- Preview text (preheader) should extend the subject, not repeat it
| Good Subject | Bad Subject |
|---|---|
| "We tested 5 tools. One stood out." | "Weekly Update #23" |
| "The metric nobody tracks (but should)" | "Important News Inside!" |
| "What I got wrong about [topic]" | "Don't Miss This!!" |
Newsletter Structure
[Subject Line]
[Preheader text - extends the subject]
[Greeting - casual, first name if available]
[Hook - 1-2 sentences, the reason to keep reading]
[Body - the substance, 2-4 short paragraphs or bullet points]
[CTA - one clear action: read, try, reply, register]
[Sign-off - brief, personal]
[P.S. - optional, for a secondary link or personal note]
Formatting Rules
- Short paragraphs: 2-3 sentences max
- Use bold for key phrases readers need to catch while scanning
- Bullet points for lists
- One link per CTA (don't scatter links everywhere)
- P.S. lines get read more than body text - use them strategically
Self-Improvement Step
After each send:
- Record open rate, click rate, and unsubscribe count in frontmatter
- Compare subject line patterns: which styles drive opens?
- Compare CTA patterns: which placements drive clicks?
- Update
content/newsletter/_insights.mdwith findings - Promote high-performing issues to
content/newsletter/_examples/
Signals
- GitHub stars
- 196
- Forks
- 58
- Last commit
- May 2026
Advanced
- Catalog kind
- skill
- Gateway key
newsletter-getnao- Source
- github.com/getnao/sylph