Newsletter skill
The issue-writing playbook Okara’s Writer Agent uses to earn the open, hold attention past the first scroll, and land one clear action.
Download the methodology, see how the agent builds a subject line and issue structure, or run it live inside the Writer Agent.
- Category
- Writer
- Agent
- Writer Agent
- Format
- newsletter.md
- Price
- Free to download
The skill file
--- name: newsletter description: Write a newsletter issue that earns the open, holds attention past the first scroll, and ends with one action worth taking. owner: Okara Writer Agent --- # Newsletter A newsletter competes with every other unread email, not with other newsletters. This skill writes an issue that survives the inbox: a subject line worth opening, a lead that pays off immediately, and a single ask at the end.
Log in to view, copy, and download the complete skill file.
About this skill
What is the Newsletter?
The Newsletter skill is the exact approach Okara’s Writer Agent follows to write an issue that performs in a crowded inbox. It covers the subject line and preview text as a pair, the two-sentence payoff that stops the scroll, a scannable section structure, and the single call to action that everything else supports.
It’s written as a SKILL.md, a plain-language instruction format that people and AI agents can both follow. Read it to fix a format that has gone stale, hand it to a writer, or let the Writer Agent draft each issue for you.
Downloading the instructions is free with an Okara account. Running the skill on a real cadence — a drafted issue waiting for you every week, in your voice — is part of the Writer Agent.
The channel itself is worth the effort: email marketing has for years posted the highest ROI of any digital channel in industry benchmark studies, commonly cited in the $30-40+ return per dollar spent range, consistently outperforming paid search and social advertising. That return only shows up if the issue actually gets opened and read, though — which is why the subject line, the two-sentence payoff, and the single call to action carry more weight per word than almost anything else you’ll write.
Example
See it in action
You ask: “Write this week’s newsletter about our new pricing — open rates have been sliding.”
Agent does: It picks one center of gravity (the price cut, not the six features shipped alongside it), then writes three subject lines with the specific number in them and a preview text that continues rather than repeats. The lead pays off in two sentences — what changed, what it costs now — before any context. Sections get real subheads so the value survives a scan, the housekeeping drops to the footer, and the issue ends with exactly one link plus a reply prompt asking which plan they’re on, because replies are the deliverability signal that pulls the next issue back up.
Comparison
The skill vs. the alternatives
| Do it yourself | Hire a freelancer or agency | Newsletter skill (free) | Writer Agent | |
|---|---|---|---|---|
| Cost | Your own time | $500–$5,000+ per project | Free with an Okara account | Included in the AI CMO plan |
| Time to first result | Hours to days, per attempt | Days to weeks, plus revision rounds | Minutes — download and follow it | Same day, runs automatically |
| Consistency over time | Depends on remembering to do it | Only as long as the retainer lasts | One-time; you re-run it yourself | Continuous, on a schedule |
| Who does the work | You, from scratch each time | Someone who has to learn your business first | You (or your agent), following the exact steps | Okara's Writer Agent, end to end |
How it works
From input to output
- 1
You give it the update
Share what this issue is about, who is on the list, and the one action you want them to take.
- 2
Okara finds the one thing
The Writer Agent picks a single center of gravity and builds the subject line and preview text around it.
- 3
It writes for the scan
You get a two-sentence payoff up top, scannable sections with real subheads, and one CTA at the end.
- 4
You send and earn replies
A specific reply prompt closes the issue, which lifts both engagement and deliverability for the next send.
What's included
Everything it covers
Subject line options
Three tested angles, best first, with the reasoning behind each one.
Preview text pairing
Writes the preview line as a second headline instead of wasting it on boilerplate.
Two-sentence payoff
Leads with the insight or number so the open is rewarded before any context.
One-to-one voice
Writes as one person to one reader, not as a brand to a segment.
Single CTA
One action per issue, because two calls to action halve each other.
Cadence structure
A repeatable format that survives past issue three without going stale.
Use cases
When to reach for it
- Fix a newsletter whose open rate has been sliding for months.
- Launch a newsletter with a format that scales beyond the first few issues.
- Turn a product update into an issue people actually finish.
- Get replies and clicks instead of silent non-unsubscribes.
- Keep a weekly cadence without a weekly writing block.
Frequently Asked Questions
Related skills
Pair it with these skills
Blog Post
The blog-writing methodology Okara’s Writer Agent follows to turn a keyword into a focused, SEO-aware post that ranks and reads like a human wrote it.
--- name: blog-post description: Write a single, focused, SEO-aware blog post — one topic, one reader, one takeaway — that ranks in search and reads like a human wrote it. owner: Okara Writer Agent --- # Blog Post Write one publish-ready blog post built around a single topic and a single reader intent, structured to earn the search click and hold attention to the
Long-Form Content
The pillar-content methodology Okara’s Writer Agent uses to write comprehensive, authoritative guides that own a topic and earn links over time.
--- name: long-form-content description: Write a comprehensive, authoritative pillar guide (2,000-5,000+ words) that covers a topic end to end, anchors a content cluster, and earns links and rankings over time. owner: Okara Writer Agent --- # Long-Form Content Produce a definitive, in-depth guide that owns a broad topic — the page a reader bookmarks and other sites link to — not a quick post. Depth, structure,
Listicle
The list-article methodology Okara’s Writer Agent uses to write scannable, curated listicles where every item earns its place and the framing makes the choice easy.
--- name: listicle description: Write a scannable list article — "N X for Y" — with a curated set of items, parallel structure, and a framing that makes the reader's decision easier. owner: Okara Writer Agent --- # Listicle Write a list-format article that's genuinely useful, not padded. Every item earns its place, the structure is consistent, and the intro and wrap-up turn a
How-To Guide
The instructional-writing methodology Okara’s Writer Agent uses to turn a task into a step-by-step guide a reader can actually follow to the finish.
--- name: how-to-guide description: Write step-by-step instructional content that takes a reader from a clear starting point to a specific outcome, with prerequisites, testable steps, and troubleshooting. owner: Okara Writer Agent --- # How-To Guide Write a guide that gets the reader to a result. The measure of success is simple: can someone follow it and finish the task? Structure, sequence, and
Content Brief
The briefing methodology Okara’s Writer Agent uses to specify a piece — goal, audience, angle, structure, and specs — so it gets written right the first time.
--- name: content-brief description: Produce a writer-ready content brief that specifies the goal, audience, angle, structure, and specs so a piece can be written correctly the first time. owner: Okara Writer Agent --- # Content Brief Write the brief, not the article. A great brief removes ambiguity so any writer — human or AI — can execute it without a round of follow-up questions
Content Outline
The outlining methodology Okara’s Writer Agent uses to build a complete, logically sequenced heading hierarchy before a single sentence gets drafted.
--- name: content-outline description: Build the structural skeleton of a piece before drafting — a heading hierarchy with bulleted talking points that covers the query completely and flows logically. owner: Okara Writer Agent --- # Content Outline Design the skeleton before anyone writes a sentence. A strong outline decides what the piece covers and in what order, so drafting becomes filling in points