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.
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.
How it works
From input to fix list
- 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 checks
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