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