Headline Writing skill
The headline methodology Okara’s Writer Agent uses to write titles, subject lines, and hooks that earn the click — clear, specific, and generated as a testable spread of angles.
Download the skill instructions, see example headline variants, or run it live inside the Writer Agent.
- Category
- Writer
- Agent
- Writer Agent
- Format
- headline-writing.md
- Price
- Free to download
The skill file
--- name: headline-writing description: Craft headlines, titles, and subject lines that earn the click — clear on the promise, sharp on specifics, and generated as a testable spread of angles. owner: Okara Writer Agent --- # Headline Writing The headline decides whether anything else gets read. This skill writes headlines that are clear on the payoff and specific enough to be believed, then gives you a spread of variants to test rather than a single guess.
Log in to view, copy, and download the complete skill file.
About this skill
What is the Headline Writing?
The Headline Writing skill is the exact instruction set Okara’s Writer Agent follows when it writes headlines. It captures how the agent clarifies the placement, states the promise plainly, works proven angles, and generates a spread of variants to test rather than a single guess.
It’s written as a SKILL.md, a plain-language instruction format that both people and AI agents can follow directly. Read it to understand what makes a headline convert, hand it to your team, or let the Writer Agent generate and sharpen headlines across your titles, subject lines, and ads.
Downloading the instructions is free with an Okara account. Running the skill continuously — generating and testing headline variants across your content and campaigns — is part of the Writer Agent.
Every other line in a piece only gets read because the headline already won an argument the reader never noticed having. That’s what makes it disproportionate: a paragraph with a weak sentence loses one reader’s attention for one sentence, but a weak headline loses the entire piece before anyone reaches the first paragraph at all. Generating a spread of angles instead of one guess is what turns headline quality from a coin flip into something you can actually test and improve.
Example
See it in action
You ask: “My post "Tips for remote onboarding" gets no clicks. Give me better headlines.”
Agent does: The current title is vague and buries the payoff. Here are eight variants across angles — Benefit: "Remote Onboarding That Gets New Hires Productive in Week One." List: "9 Remote Onboarding Tactics That Cut Ramp Time in Half." Question: "Why Do Remote Hires Take So Long to Ramp — and How Do You Fix It?" Contrarian: "Most Remote Onboarding Fails in the First 48 Hours. Here’s the Fix." All under 60 characters where it’s an SEO title, keyword front-loaded. My pick is the list variant for CTR; I’d A/B it against the benefit one.
Comparison
The skill vs. the alternatives
| Do it yourself | Hire a freelancer or agency | Headline Writing 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 the topic and placement
Tell the Writer Agent the piece or topic and where the headline runs — SEO title, email, ad, or social.
- 2
Okara states the promise
The agent nails the core benefit in plain words, then decides the clarity-versus-curiosity balance for the placement.
- 3
It works the angles
Variants generated across proven angles — benefit, how-to, list, question, contrarian, and specificity — then sharpened.
- 4
You get a testable spread
A ranked set labeled by angle, within length limits, with a recommended pick and A/B pairs to test.
What's included
Everything it covers
Angle coverage
Generates across benefit, how-to, list, question, contrarian, and specificity angles.
Placement-aware writing
Tunes clarity versus curiosity for SEO titles, subject lines, ads, and social hooks.
Specificity sharpening
Adds numbers, outcomes, and timeframes and strips hype so headlines earn belief.
Constraint checking
Respects length limits and front-loads the keyword for SEO placements.
Variant generation
Produces a spread of options to test, not a single line to hope on.
A/B recommendations
Flags a recommended pick and the pairs worth testing against each other.
Use cases
When to reach for it
- Fix a strong post that’s under-read because of a weak title.
- Write email subject lines that lift open rates.
- Generate ad headlines that fit platform limits and pull clicks.
- Produce variants to A/B test instead of guessing one line.
- Craft social hooks that stop the scroll.
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