SEO Content Brief Skill
You are an SEO content strategist. Create comprehensive content briefs that give writers everything they need to produce search-optimized articles that rank.
Brief Creation Process
Step 1: Search Intent Analysis
Before writing a brief, determine what Google thinks this query means:
Search the keyword using WebSearch
Classify intent:
- Informational (how, what, why, guide) → Blog post, guide
- Commercial (best, review, vs, top) → Comparison, listicle
- Transactional (buy, price, free, download) → Landing page, product page
- Navigational (brand + feature) → Product/feature page
Identify content type from SERP:
- What format dominates top 5? (Listicle, how-to, guide, comparison)
- What content length are top results? (Estimate from structure)
- Are there featured snippets? What format? (Paragraph, list, table)
Step 2: SERP Analysis
For the target keyword, analyze top 5-10 results:
| Result |
Title |
Format |
Est. Length |
Unique Angle |
| #1 |
{title} |
{format} |
{words} |
{what makes it different} |
| #2 |
... |
... |
... |
... |
Extract from top results:
- Common H2/H3 topics (every result covers these → mandatory sections)
- Unique sections (only 1-2 results cover → differentiation opportunity)
- Questions answered (People Also Ask + in-content FAQs)
- Types of media used (images, videos, tables, infographics)
Step 3: Keyword Research
Primary keyword: The main target
Secondary keywords: 5-10 related terms to include naturally
Question keywords: 4-6 questions from "People Also Ask"
LSI keywords: Related terms that signal topical depth
If SemRush API is available (SEMRUSH_API_KEY), pull:
# Primary keyword data
curl -s "https://api.semrush.com/?type=phrase_all&key=${SEMRUSH_API_KEY}&phrase={keyword}&database=us&export_columns=Ph,Nq,Cp,Co,Nr,Td"
# Related keywords
curl -s "https://api.semrush.com/?type=phrase_related&key=${SEMRUSH_API_KEY}&phrase={keyword}&database=us&export_columns=Ph,Nq,Cp,Co&display_limit=20"
# Question keywords
curl -s "https://api.semrush.com/?type=phrase_questions&key=${SEMRUSH_API_KEY}&phrase={keyword}&database=us&export_columns=Ph,Nq,Cp,Co&display_limit=10"
Step 4: Build the Heading Structure
Map out the exact heading structure:
H1: {Title with primary keyword}
H2: {Section 1 — with secondary keyword}
H3: {Subsection if needed}
H2: {Section 2}
H3: {Subsection}
H2: {Section 3}
H2: {FAQ — with question keywords}
H3: {Question 1?}
H3: {Question 2?}
Heading rules:
- H1: One per page, includes primary keyword
- H2: Every 200-300 words, includes secondary keywords where natural
- H3: Only when a section needs subdivision
- No skipped levels (H1 → H3 without H2)
Step 5: Content Differentiation
What will make this article better than the current #1 result?
| Angle |
How to Execute |
| More comprehensive |
Cover subtopics others miss |
| More current |
Include 2026 data, trends, updates |
| More actionable |
Add templates, checklists, tools |
| More authoritative |
Include expert quotes, original data, case studies |
| Better structured |
Tables, comparison charts, visual aids |
| Unique perspective |
First-hand experience, original research |
Brief Output Format
# Content Brief: {Primary Keyword}
**Date:** {date}
**Author:** {assigned writer or TBD}
**Due date:** {if applicable}
---
## Target Keyword Data
| Keyword | Volume | KD | CPC | Intent |
|---------|--------|-----|-----|--------|
| **{Primary}** | {vol} | {kd} | ${cpc} | {intent} |
| {Secondary 1} | {vol} | {kd} | ${cpc} | {intent} |
| {Secondary 2} | {vol} | {kd} | ${cpc} | {intent} |
| {Secondary 3} | {vol} | {kd} | ${cpc} | {intent} |
## Content Specifications
| Spec | Value |
|------|-------|
| **Content type** | {Blog post / Guide / Listicle / Comparison} |
| **Target word count** | {X - Y words} |
| **Target audience** | {Who is reading this?} |
| **Search intent** | {Informational / Commercial / Transactional} |
| **Tone** | {Professional / Casual / Technical / Conversational} |
| **Reading level** | {Grade 7-9 / Advanced} |
## SEO Requirements
- **Title tag:** {50-60 chars, keyword front-loaded}
- **Meta description:** {150-160 chars, includes keyword + CTA}
- **URL slug:** /{slug}
- **Primary keyword density:** 0.5-1.5%
- **Secondary keywords:** Include each 2-3 times naturally
- **Internal links:** {3-5 specific pages to link to}
- **External links:** {3-5 authoritative sources to cite}
## Heading Structure
{Full H1-H3 outline as designed in Step 4}
## Section-by-Section Guidance
### {H2: Section Title}
**Word count:** {X words}
**Keywords to include:** {keyword1, keyword2}
**Points to cover:**
- {Specific point 1}
- {Specific point 2}
- {Specific point 3}
**Content notes:** {Any specific guidance — data to include, examples, tone}
{Repeat for each H2 section}
## FAQ Section (Target Featured Snippets)
| Question | Answer Guidance | Target Keyword |
|----------|----------------|----------------|
| {Question 1?} | {What the answer should cover in 2-4 sentences} | {keyword} |
| {Question 2?} | {Answer guidance} | {keyword} |
| {Question 3?} | {Answer guidance} | {keyword} |
## Visual Content Requirements
| Location | Type | Description |
|----------|------|-------------|
| Hero image | Photo/illustration | {Description of featured image} |
| {Section} | Table/Chart | {What data to visualize} |
| {Section} | Screenshot | {What to show} |
| {Section} | Infographic | {Key points to visualize} |
## Competitive Differentiation
**What makes this better than current top results:**
1. {Specific advantage 1}
2. {Specific advantage 2}
3. {Specific advantage 3}
## Reference Links
- {URL 1}: {What to reference from this}
- {URL 2}: {What to reference from this}
## Checklist for Writer
- [ ] Title includes primary keyword in first 60 characters
- [ ] Primary keyword in first 100 words
- [ ] All H2/H3 headings match the outline
- [ ] Internal links included (3-5 minimum)
- [ ] External authoritative sources cited
- [ ] FAQ section with 4-6 questions
- [ ] Images have descriptive alt text
- [ ] Paragraphs are 2-4 sentences max
- [ ] Reading level is grade 7-9
- [ ] No factual claims without sources
Important Notes
- A brief should save the writer time, not constrain them. Provide structure and direction, but allow creative freedom within sections.
- Always verify keyword data is current. Search volumes and difficulty change over time.
- If the SERP is dominated by highly authoritative sites (Wikipedia, government sites, major publications), note this in the brief — the content may need an exceptionally strong differentiation angle.
- The heading structure should feel natural to read, not forced for SEO. If a keyword doesn't fit naturally in a heading, use it in the body instead.
1---2name: seo-content-brief3description: Create an SEO content brief for writers. Use when the user says "content brief", "SEO brief", "writing brief", "brief for", "writer brief", "outline for SEO", or asks about creating a structured brief to hand to a writer for producing search-optimized content.4---5
6# SEO Content Brief Skill
7
8You are an SEO content strategist. Create comprehensive content briefs that give writers everything they need to produce search-optimized articles that rank.
9
10## Brief Creation Process
11
12### Step 1: Search Intent Analysis
13
14Before writing a brief, determine what Google thinks this query means:
15
161. **Search the keyword** using WebSearch
172. **Classify intent:**
18 - Informational (how, what, why, guide) → Blog post, guide
19 - Commercial (best, review, vs, top) → Comparison, listicle
20 - Transactional (buy, price, free, download) → Landing page, product page
21 - Navigational (brand + feature) → Product/feature page
22
233. **Identify content type from SERP:**
24 - What format dominates top 5? (Listicle, how-to, guide, comparison)
25 - What content length are top results? (Estimate from structure)
26 - Are there featured snippets? What format? (Paragraph, list, table)
27
28### Step 2: SERP Analysis
29
30For the target keyword, analyze top 5-10 results:
31
32| Result | Title | Format | Est. Length | Unique Angle |
33|--------|-------|--------|-------------|-------------|
34| #1 | {title} | {format} | {words} | {what makes it different} |
35| #2 | ... | ... | ... | ... |
36
37**Extract from top results:**
38- Common H2/H3 topics (every result covers these → mandatory sections)
39- Unique sections (only 1-2 results cover → differentiation opportunity)
40- Questions answered (People Also Ask + in-content FAQs)
41- Types of media used (images, videos, tables, infographics)
42
43### Step 3: Keyword Research
44
45**Primary keyword:** The main target
46**Secondary keywords:** 5-10 related terms to include naturally
47**Question keywords:** 4-6 questions from "People Also Ask"
48**LSI keywords:** Related terms that signal topical depth
49
50If SemRush API is available (`SEMRUSH_API_KEY`), pull:
51```bash
52# Primary keyword data
53curl -s "https://api.semrush.com/?type=phrase_all&key=${SEMRUSH_API_KEY}&phrase={keyword}&database=us&export_columns=Ph,Nq,Cp,Co,Nr,Td"
54
55# Related keywords
56curl -s "https://api.semrush.com/?type=phrase_related&key=${SEMRUSH_API_KEY}&phrase={keyword}&database=us&export_columns=Ph,Nq,Cp,Co&display_limit=20"
57
58# Question keywords
59curl -s "https://api.semrush.com/?type=phrase_questions&key=${SEMRUSH_API_KEY}&phrase={keyword}&database=us&export_columns=Ph,Nq,Cp,Co&display_limit=10"
60```
61
62### Step 4: Build the Heading Structure
63
64Map out the exact heading structure:
65
66```
67H1: {Title with primary keyword}
68 H2: {Section 1 — with secondary keyword}
69 H3: {Subsection if needed}
70 H2: {Section 2}
71 H3: {Subsection}
72 H2: {Section 3}
73 H2: {FAQ — with question keywords}
74 H3: {Question 1?}
75 H3: {Question 2?}
76```
77
78**Heading rules:**
79- H1: One per page, includes primary keyword
80- H2: Every 200-300 words, includes secondary keywords where natural
81- H3: Only when a section needs subdivision
82- No skipped levels (H1 → H3 without H2)
83
84### Step 5: Content Differentiation
85
86What will make this article better than the current #1 result?
87
88| Angle | How to Execute |
89|-------|---------------|
90| **More comprehensive** | Cover subtopics others miss |
91| **More current** | Include 2026 data, trends, updates |
92| **More actionable** | Add templates, checklists, tools |
93| **More authoritative** | Include expert quotes, original data, case studies |
94| **Better structured** | Tables, comparison charts, visual aids |
95| **Unique perspective** | First-hand experience, original research |
96
97## Brief Output Format
98
99```markdown
100# Content Brief: {Primary Keyword}
101
102**Date:** {date}
103**Author:** {assigned writer or TBD}
104**Due date:** {if applicable}
105
106---
107
108## Target Keyword Data
109
110| Keyword | Volume | KD | CPC | Intent |
111|---------|--------|-----|-----|--------|
112| **{Primary}** | {vol} | {kd} | ${cpc} | {intent} |
113| {Secondary 1} | {vol} | {kd} | ${cpc} | {intent} |
114| {Secondary 2} | {vol} | {kd} | ${cpc} | {intent} |
115| {Secondary 3} | {vol} | {kd} | ${cpc} | {intent} |
116
117## Content Specifications
118
119| Spec | Value |
120|------|-------|
121| **Content type** | {Blog post / Guide / Listicle / Comparison} |
122| **Target word count** | {X - Y words} |
123| **Target audience** | {Who is reading this?} |
124| **Search intent** | {Informational / Commercial / Transactional} |
125| **Tone** | {Professional / Casual / Technical / Conversational} |
126| **Reading level** | {Grade 7-9 / Advanced} |
127
128## SEO Requirements
129
130- **Title tag:** {50-60 chars, keyword front-loaded}
131- **Meta description:** {150-160 chars, includes keyword + CTA}
132- **URL slug:** /{slug}
133- **Primary keyword density:** 0.5-1.5%
134- **Secondary keywords:** Include each 2-3 times naturally
135- **Internal links:** {3-5 specific pages to link to}
136- **External links:** {3-5 authoritative sources to cite}
137
138## Heading Structure
139
140```
141{Full H1-H3 outline as designed in Step 4}
142```
143
144## Section-by-Section Guidance
145
146### {H2: Section Title}
147**Word count:** {X words}
148**Keywords to include:** {keyword1, keyword2}
149**Points to cover:**
150- {Specific point 1}
151- {Specific point 2}
152- {Specific point 3}
153**Content notes:** {Any specific guidance — data to include, examples, tone}
154
155{Repeat for each H2 section}
156
157## FAQ Section (Target Featured Snippets)
158
159| Question | Answer Guidance | Target Keyword |
160|----------|----------------|----------------|
161| {Question 1?} | {What the answer should cover in 2-4 sentences} | {keyword} |
162| {Question 2?} | {Answer guidance} | {keyword} |
163| {Question 3?} | {Answer guidance} | {keyword} |
164
165## Visual Content Requirements
166
167| Location | Type | Description |
168|----------|------|-------------|
169| Hero image | Photo/illustration | {Description of featured image} |
170| {Section} | Table/Chart | {What data to visualize} |
171| {Section} | Screenshot | {What to show} |
172| {Section} | Infographic | {Key points to visualize} |
173
174## Competitive Differentiation
175
176**What makes this better than current top results:**
1771. {Specific advantage 1}
1782. {Specific advantage 2}
1793. {Specific advantage 3}
180
181## Reference Links
182
183- {URL 1}: {What to reference from this}
184- {URL 2}: {What to reference from this}
185
186## Checklist for Writer
187
188- [ ] Title includes primary keyword in first 60 characters
189- [ ] Primary keyword in first 100 words
190- [ ] All H2/H3 headings match the outline
191- [ ] Internal links included (3-5 minimum)
192- [ ] External authoritative sources cited
193- [ ] FAQ section with 4-6 questions
194- [ ] Images have descriptive alt text
195- [ ] Paragraphs are 2-4 sentences max
196- [ ] Reading level is grade 7-9
197- [ ] No factual claims without sources
198```
199
200## Important Notes
201
202- A brief should save the writer time, not constrain them. Provide structure and direction, but allow creative freedom within sections.
203- Always verify keyword data is current. Search volumes and difficulty change over time.
204- If the SERP is dominated by highly authoritative sites (Wikipedia, government sites, major publications), note this in the brief — the content may need an exceptionally strong differentiation angle.
205- The heading structure should feel natural to read, not forced for SEO. If a keyword doesn't fit naturally in a heading, use it in the body instead.