Content Brief skill
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.
Download the skill instructions, see an example brief, or run it live inside the Writer Agent.
- Category
- Writer
- Agent
- Writer Agent
- Format
- content-brief.md
- Price
- Free to download
The skill file
--- 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 and without missing the strategic intent.
Log in to view, copy, and download the complete skill file.
About this skill
What is the Content Brief?
The Content Brief skill is the exact instruction set Okara’s Writer Agent follows when it writes a brief. It captures how the agent locks the goal, profiles the audience, sets a differentiating angle, and specifies structure — so a writer, human or AI, can execute without guesswork.
It’s written as a SKILL.md, a plain-language instruction format that both people and AI agents can follow directly. Read it to standardize how your team briefs work, hand it to your editors, or let the Writer Agent generate briefs for your topic pipeline.
Downloading the instructions is free with an Okara account. Running the skill continuously to brief every piece in your content pipeline is part of the Writer Agent.
That homework happens before anyone reaches a writer: B2B buyers now complete a large majority of their own research — commonly cited estimates put it at roughly 60–70%+ of the buying journey — before contacting a salesperson, working through several pieces of content along the way. A brief is where that reality gets built in or gets ignored: get the angle and audience wrong and the piece joins the pile a self-educating buyer skims past; get it right and it’s one of the few that earns the read.
Example
See it in action
You ask: “Brief a post targeting "marketing attribution models" for our analytics tool.”
Agent does: Goal: rank for "marketing attribution models", mid-funnel, to feed your analytics trial. Audience: growth marketers who know the term but not which model to use — takeaway is "pick the right model for your sales cycle." Angle: a practical picker, not another definitions listicle. Structure: three title options, seven required H2s (one per model plus a "how to choose" section), and the key point each must land. Specs: 1,800 words, expert-but-plain voice, five required entities, two internal links, CTA to your attribution feature. Plus three sources to cite and the two competitor posts to beat.
Comparison
The skill vs. the alternatives
| Do it yourself | Hire a freelancer or agency | Content Brief 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 a topic and goal
Tell the Writer Agent the topic or keyword and the business objective the piece needs to serve.
- 2
Okara locks the strategy
The agent defines intent and funnel stage, profiles the audience, and sets the angle that differentiates the piece.
- 3
It specifies the piece
Title options, required H2s, points per section, and full specs — word count, voice, keywords, links, and CTA.
- 4
You get a writer-ready brief
A one-page brief any writer can execute without follow-up questions, with references and competitors to beat.
What's included
Everything it covers
Goal & intent definition
Target keyword, search intent, funnel stage, and the business objective the piece serves.
Audience profile
Who the reader is, their pain and sophistication, and the one takeaway they must leave with.
Differentiating angle
The specific take that sets the piece apart from what already ranks.
Structure spec
Working title options, required H2s, and the key points each section must cover.
Production specs
Word count, tone, required keywords and entities, internal and external links, and the CTA.
References to beat
Sources to cite, competitor URLs to outdo, and data or examples to include.
Use cases
When to reach for it
- Assign a piece to a freelancer and get it right the first time.
- Standardize how your team briefs so output is consistent across writers.
- Lock intent, angle, and structure before anyone starts drafting.
- Feed a clear spec to an AI writer so drafts come back on-target.
- Stop off-brief drafts by fixing ambiguity at the source.
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 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
Content Calendar
The planning methodology Okara’s Writer Agent uses to turn goals into a dated content calendar — themes, formats, keywords, and channels on a cadence you can sustain.
--- name: content-calendar description: Plan and schedule content over time — mapping themes, formats, keywords, and channels to a realistic cadence so publishing becomes a system, not a scramble. owner: Okara Writer Agent --- # Content Calendar Turn goals into a dated publishing plan. A calendar decides what gets made, when, on which channel, and why — so the team ships consistently instead of