Blog Brief Generator: Content Planning
Generates comprehensive content briefs that guide blog writing for maximum
impact on both Google rankings and AI citation platforms.
Reference documents:
references/content-templates.md: template selection criteria
references/distribution-playbook.md: channel-specific distribution tactics
references/internal-linking.md: link architecture patterns
skills/blog/references/research-quality.md - 5-dim quality rubric, pre-flight trap classes, freshness floors (v1.8.0; cross-skill ref lives in the orchestrator's references dir)
skills/blog/references/synthesis-contract.md - 6 LAWs for synthesis output (v1.8.0)
Auto-loaded inputs (v1.8.0)
When DISCOURSE.md is present at the project root (produced by /blog discourse), load it before starting brief generation. Use the discourse brief's "What's NEW" themes, "Consensus" themes, and "Contrarian takes" sections to enrich the competitive landscape and information-gain sections of this brief. Cite from DISCOURSE.md using the same inline [name](url) pattern. If DISCOURSE.md is absent, behavior is unchanged.
Cross-reference
For evidence-led keyword discovery, audience-avatar prompts, and content prioritization (directly upstream of brief generation), see /blog flow find.
Workflow
Step 1: Topic Intake
Gather from the user:
- Topic or keyword (required)
- Target audience (who reads this?)
- Search intent: Informational, commercial, transactional, navigational
- Business context: What does the company do? What's the CTA?
If only a topic is given, infer the rest from context.
Step 2: Keyword Research
Using WebSearch:
- Search for the target keyword; analyze what currently ranks
- Identify primary keyword (exact match target)
- Identify 3-5 secondary keywords (related terms, long-tail)
- Identify 3-5 question queries (People Also Ask style)
- Note the search intent: what do searchers actually want?
Step 2.5: Template Recommendation
Analyze the topic, search intent, and competitive landscape to recommend one
of 12 content templates. Load references/content-templates.md for selection
criteria.
Available templates:
| Template |
Best For |
how-to-guide |
Step-by-step instructional content |
listicle |
Curated lists, ranked items, resource roundups |
case-study |
In-depth analysis of a specific example or result |
comparison |
Side-by-side evaluation of 2+ options |
pillar-page |
Comprehensive topic hub linking to cluster content |
product-review |
Detailed evaluation with pros/cons/verdict |
thought-leadership |
Expert opinion, industry trends, predictions |
roundup |
Expert quotes, tool collections, best-of lists |
tutorial |
Technical walkthrough with code/config examples |
news-analysis |
Timely coverage with expert commentary |
data-research |
Original data, survey results, benchmark findings |
faq-knowledge |
Question-driven reference content |
Selection process:
- Match search intent to template strength
- Check what format top-ranking competitors use
- Consider the user's available assets (data, expertise, tools)
- Load the matching template file from
templates/[type].md
- Include the template name in the brief output
Step 3: Competitive Analysis
Analyze the top 3-5 ranking pages for the target keyword:
- Content length: What's the average word count?
- Heading structure: How many H2s? What topics do they cover?
- Visual elements: Do competitors use charts, images, videos?
- Content gaps: What do all competitors miss?
- Freshness: How recently were they updated?
- Schema: Do they use FAQ or other rich results? (Note: HowTo deprecated Sept 2023)
- Template pattern: What content format do top results use?
Step 4: Statistics Research
Find 8-12 statistics the article should include:
- Search:
[topic] study 2025 2026 data statistics research
- Prioritize tier 1-3 sources
- For each stat, record: value, source, URL, date, methodology
- Identify 2-4 stats suitable for chart visualization
- Identify 1-2 stats suitable for TL;DR and social sharing
Step 5: Generate the Brief
Output format:
# Content Brief: [Title Suggestion]
## Template
**Recommended**: [template-name]: [1-sentence rationale]
**Template file**: `templates/[type].md`
## Target Keywords
- **Primary**: [keyword]: [estimated monthly search volume if available]
- **Secondary**: [keyword 1], [keyword 2], [keyword 3]
- **Questions**: [question 1], [question 2], [question 3]
## Search Intent
[Informational/Commercial/Transactional]: [1-2 sentence explanation of
what the searcher wants]
## Content Parameters
- **Word count**: [2,000-2,500] words
- **Reading level**: Flesch 60-70 (expert-accessible)
- **Format**: [Markdown/MDX/HTML]
- **H2 sections**: [6-8]
- **Images**: 3-5 from Pixabay/Unsplash
- **Charts**: 2-4 via built-in blog-chart (diverse types)
- **FAQ items**: 3-5
## Recommended Title
[Question-format title including primary keyword, under 60 chars]
Alternative titles:
1. [Option 2]
2. [Option 3]
## Meta Description
[150-160 chars, fact-dense, includes 1 statistic, ends with value proposition]
## TL;DR Draft
> **TL;DR:** [40-60 word summary with key finding + 1 statistic + source.
> Should be self-contained; a reader who only reads this box gets the
> core value of the article.]
## Information Gain Opportunities
- **[ORIGINAL DATA]**: [Suggestion for proprietary data, survey, experiment,
or benchmark the author can produce to differentiate this post]
- **[PERSONAL EXPERIENCE]**: [Suggestion for first-hand observation, test
result, or case study to include: "When we tested X, we found Y"]
- **[UNIQUE INSIGHT]**: [Suggestion for contrarian take, novel analysis,
or non-obvious connection that competitors have not covered]
## Content Outline
### Introduction (100-150 words)
- Hook: [Surprising statistic to open with]
- Problem: [What challenge does the reader face?]
- Promise: [What will they learn?]
- TL;DR box placement (after hook, before first H2)
### H2: [Question Format] (300-400 words)
- **Answer-first**: Open with [specific stat + source]
- Cover: [subtopic 1], [subtopic 2]
- **Image**: [Description of recommended image]
- **Key stat**: [Specific statistic to include]
### H2: [Question Format] (300-400 words)
- **Answer-first**: Open with [specific stat + source]
- Cover: [subtopic 1], [subtopic 2]
- **Chart**: [Type] showing [data description]
- **Key stat**: [Specific statistic to include]
[... repeat for 6-8 sections ...]
### FAQ Section (3-5 items)
1. [Question]: Answer with [stat + source]
2. [Question]: Answer with [stat + source]
3. [Question]: Answer with [stat + source]
### Conclusion (100-150 words)
- Key takeaways (bulleted)
- Call to action: [What should the reader do next?]
## Statistics to Include
| # | Statistic | Source | Year | Section |
|---|-----------|--------|------|---------|
| 1 | [stat] | [source + URL] | 2025 | H2: Section 1 |
| 2 | [stat] | [source + URL] | 2026 | H2: Section 2 |
| ... | ... | ... | ... | ... |
## Citation Capsule Plan
For each H2, plan a 40-60 word self-contained passage optimized for AI
extraction. Each capsule should include a stat, its source, and a clear
claim that can stand alone when quoted.
| Section | Capsule Focus | Key Stat | Source |
|---------|--------------|----------|--------|
| H2: [Section 1] | [Core claim this section makes] | [stat] | [source] |
| H2: [Section 2] | [Core claim this section makes] | [stat] | [source] |
| H2: [Section 3] | [Core claim this section makes] | [stat] | [source] |
| ... | ... | ... | ... |
## Cover Image
| Option | Details |
|--------|---------|
| Photo cover | [Pixabay/Unsplash/Pexels search terms for wide hero image] |
| Generated SVG | [Text-on-gradient concept with key stat, if data-heavy topic] |
| Dimensions | 1200x630 (OG-compatible) |
## Visual Element Plan
| # | Type | Data | Section |
|---|------|------|---------|
| 1 | [Bar chart] | [Data description] | H2: Section 2 |
| 2 | [Donut chart] | [Data description] | H2: Section 4 |
| 3 | [Image: Pixabay] | [Search terms] | H2: Section 1 |
| 4 | [Image: Pixabay] | [Search terms] | H2: Section 3 |
## Competitive Gaps to Exploit
1. [What competitors miss that we should cover]
2. [Unique angle or original data we can provide]
3. [Format advantage: charts/visuals competitors lack]
## Internal Link Architecture
- **Link TO** (from this new post to existing pages):
1. [Page title/URL] - anchor text: "[descriptive anchor]"
2. [Page title/URL] - anchor text: "[descriptive anchor]"
3. [Page title/URL] - anchor text: "[descriptive anchor]"
4. [Page title/URL] - anchor text: "[descriptive anchor]"
5. [Page title/URL] - anchor text: "[descriptive anchor]"
- **Link FROM** (update these existing pages to link to this new post):
1. [Page title/URL] - anchor text: "[descriptive anchor]"
2. [Page title/URL] - anchor text: "[descriptive anchor]"
3. [Page title/URL] - anchor text: "[descriptive anchor]"
4. [Page title/URL] - anchor text: "[descriptive anchor]"
5. [Page title/URL] - anchor text: "[descriptive anchor]"
- **Pillar connection**: [Which pillar page this belongs to, if applicable]
- **Cluster position**: [Hub / Spoke / Standalone]
## E-E-A-T Signals to Include
- **Experience**: [First-hand insight, case study, or test result]
- **Expertise**: [Author credentials relevant to topic]
- **Authority**: [Industry recognition, citations, partnerships]
- **Trust**: [Transparency, sourced data, no self-promotion]
## Distribution Plan
- **Reddit**: [Specific subreddits (r/sub1, r/sub2), posting approach (value-first
comment vs. link post), authentic participation strategy, timing]
- **YouTube**: [Video companion concept, estimated length, key visuals from the
post to reuse, thumbnail idea]
- **LinkedIn**: [Article excerpt angle, target audience segment, best posting
time for the niche, engagement hook]
- **Email**: [Newsletter excerpt (2-3 sentences), subject line suggestion,
CTA linking back to the full post]
- **Twitter/X**: [Thread hook (first tweet), 3-5 key tweet ideas built from
statistics in the post, hashtag suggestions]
Step 6: Save the Brief
Save to the user's project as briefs/[slug]-brief.md or to a location
they specify. Confirm the brief is ready for /blog write.
1---
2name: blog-brief
3description: >
4 Generate detailed content briefs for blog posts with target keywords,
5 content outlines, competitive analysis, recommended statistics, image and
6 chart suggestions, word count targets, internal linking architecture,
7 template recommendations (12 types), TL;DR drafts, citation capsule
8 planning, information gain prompts, and multi-channel distribution plans.
9 Briefs are optimized for Google rankings and AI citations (GEO/AEO). Use
10 when user says "content brief", "blog brief", "write brief", "outline blog",
11 "plan blog post", "blog outline", "content outline".
12user-invokable: true
13argument-hint: "<topic>"
14license: MIT
15metadata:
16 source: https://skillmd.com/skills/om-scogo/blog-brief
17---
18
19# Blog Brief Generator: Content Planning
20
21Generates comprehensive content briefs that guide blog writing for maximum
22impact on both Google rankings and AI citation platforms.
23
24Reference documents:
25- `references/content-templates.md`: template selection criteria
26- `references/distribution-playbook.md`: channel-specific distribution tactics
27- `references/internal-linking.md`: link architecture patterns
28- `skills/blog/references/research-quality.md` - 5-dim quality rubric, pre-flight trap classes, freshness floors (v1.8.0; cross-skill ref lives in the orchestrator's references dir)
29- `skills/blog/references/synthesis-contract.md` - 6 LAWs for synthesis output (v1.8.0)
30
31## Auto-loaded inputs (v1.8.0)
32
33When `DISCOURSE.md` is present at the project root (produced by `/blog discourse`), load it before starting brief generation. Use the discourse brief's "What's NEW" themes, "Consensus" themes, and "Contrarian takes" sections to enrich the competitive landscape and information-gain sections of this brief. Cite from DISCOURSE.md using the same inline `[name](url)` pattern. If DISCOURSE.md is absent, behavior is unchanged.
34
35## Cross-reference
36
37For evidence-led keyword discovery, audience-avatar prompts, and content prioritization (directly upstream of brief generation), see `/blog flow find`.
38
39## Workflow
40
41### Step 1: Topic Intake
42
43Gather from the user:
441. **Topic or keyword** (required)
452. **Target audience** (who reads this?)
463. **Search intent**: Informational, commercial, transactional, navigational
474. **Business context**: What does the company do? What's the CTA?
48
49If only a topic is given, infer the rest from context.
50
51### Step 2: Keyword Research
52
53Using WebSearch:
541. Search for the target keyword; analyze what currently ranks
552. Identify **primary keyword** (exact match target)
563. Identify **3-5 secondary keywords** (related terms, long-tail)
574. Identify **3-5 question queries** (People Also Ask style)
585. Note the **search intent**: what do searchers actually want?
59
60### Step 2.5: Template Recommendation
61
62Analyze the topic, search intent, and competitive landscape to recommend one
63of 12 content templates. Load `references/content-templates.md` for selection
64criteria.
65
66**Available templates:**
67| Template | Best For |
68|----------|----------|
69| `how-to-guide` | Step-by-step instructional content |
70| `listicle` | Curated lists, ranked items, resource roundups |
71| `case-study` | In-depth analysis of a specific example or result |
72| `comparison` | Side-by-side evaluation of 2+ options |
73| `pillar-page` | Comprehensive topic hub linking to cluster content |
74| `product-review` | Detailed evaluation with pros/cons/verdict |
75| `thought-leadership` | Expert opinion, industry trends, predictions |
76| `roundup` | Expert quotes, tool collections, best-of lists |
77| `tutorial` | Technical walkthrough with code/config examples |
78| `news-analysis` | Timely coverage with expert commentary |
79| `data-research` | Original data, survey results, benchmark findings |
80| `faq-knowledge` | Question-driven reference content |
81
82**Selection process:**
831. Match search intent to template strength
842. Check what format top-ranking competitors use
853. Consider the user's available assets (data, expertise, tools)
864. Load the matching template file from `templates/[type].md`
875. Include the template name in the brief output
88
89### Step 3: Competitive Analysis
90
91Analyze the top 3-5 ranking pages for the target keyword:
921. **Content length**: What's the average word count?
932. **Heading structure**: How many H2s? What topics do they cover?
943. **Visual elements**: Do competitors use charts, images, videos?
954. **Content gaps**: What do all competitors miss?
965. **Freshness**: How recently were they updated?
976. **Schema**: Do they use FAQ or other rich results? (Note: HowTo deprecated Sept 2023)
987. **Template pattern**: What content format do top results use?
99
100### Step 4: Statistics Research
101
102Find 8-12 statistics the article should include:
1031. Search: `[topic] study 2025 2026 data statistics research`
1042. Prioritize tier 1-3 sources
1053. For each stat, record: value, source, URL, date, methodology
1064. Identify 2-4 stats suitable for chart visualization
1075. Identify 1-2 stats suitable for TL;DR and social sharing
108
109### Step 5: Generate the Brief
110
111Output format:
112
113```
114# Content Brief: [Title Suggestion]
115
116## Template
117**Recommended**: [template-name]: [1-sentence rationale]
118**Template file**: `templates/[type].md`
119
120## Target Keywords
121- **Primary**: [keyword]: [estimated monthly search volume if available]
122- **Secondary**: [keyword 1], [keyword 2], [keyword 3]
123- **Questions**: [question 1], [question 2], [question 3]
124
125## Search Intent
126[Informational/Commercial/Transactional]: [1-2 sentence explanation of
127what the searcher wants]
128
129## Content Parameters
130- **Word count**: [2,000-2,500] words
131- **Reading level**: Flesch 60-70 (expert-accessible)
132- **Format**: [Markdown/MDX/HTML]
133- **H2 sections**: [6-8]
134- **Images**: 3-5 from Pixabay/Unsplash
135- **Charts**: 2-4 via built-in blog-chart (diverse types)
136- **FAQ items**: 3-5
137
138## Recommended Title
139[Question-format title including primary keyword, under 60 chars]
140
141Alternative titles:
1421. [Option 2]
1432. [Option 3]
144
145## Meta Description
146[150-160 chars, fact-dense, includes 1 statistic, ends with value proposition]
147
148## TL;DR Draft
149> **TL;DR:** [40-60 word summary with key finding + 1 statistic + source.
150> Should be self-contained; a reader who only reads this box gets the
151> core value of the article.]
152
153## Information Gain Opportunities
154- **[ORIGINAL DATA]**: [Suggestion for proprietary data, survey, experiment,
155 or benchmark the author can produce to differentiate this post]
156- **[PERSONAL EXPERIENCE]**: [Suggestion for first-hand observation, test
157 result, or case study to include: "When we tested X, we found Y"]
158- **[UNIQUE INSIGHT]**: [Suggestion for contrarian take, novel analysis,
159 or non-obvious connection that competitors have not covered]
160
161## Content Outline
162
163### Introduction (100-150 words)
164- Hook: [Surprising statistic to open with]
165- Problem: [What challenge does the reader face?]
166- Promise: [What will they learn?]
167- TL;DR box placement (after hook, before first H2)
168
169### H2: [Question Format] (300-400 words)
170- **Answer-first**: Open with [specific stat + source]
171- Cover: [subtopic 1], [subtopic 2]
172- **Image**: [Description of recommended image]
173- **Key stat**: [Specific statistic to include]
174
175### H2: [Question Format] (300-400 words)
176- **Answer-first**: Open with [specific stat + source]
177- Cover: [subtopic 1], [subtopic 2]
178- **Chart**: [Type] showing [data description]
179- **Key stat**: [Specific statistic to include]
180
181[... repeat for 6-8 sections ...]
182
183### FAQ Section (3-5 items)
1841. [Question]: Answer with [stat + source]
1852. [Question]: Answer with [stat + source]
1863. [Question]: Answer with [stat + source]
187
188### Conclusion (100-150 words)
189- Key takeaways (bulleted)
190- Call to action: [What should the reader do next?]
191
192## Statistics to Include
193
194| # | Statistic | Source | Year | Section |
195|---|-----------|--------|------|---------|
196| 1 | [stat] | [source + URL] | 2025 | H2: Section 1 |
197| 2 | [stat] | [source + URL] | 2026 | H2: Section 2 |
198| ... | ... | ... | ... | ... |
199
200## Citation Capsule Plan
201For each H2, plan a 40-60 word self-contained passage optimized for AI
202extraction. Each capsule should include a stat, its source, and a clear
203claim that can stand alone when quoted.
204
205| Section | Capsule Focus | Key Stat | Source |
206|---------|--------------|----------|--------|
207| H2: [Section 1] | [Core claim this section makes] | [stat] | [source] |
208| H2: [Section 2] | [Core claim this section makes] | [stat] | [source] |
209| H2: [Section 3] | [Core claim this section makes] | [stat] | [source] |
210| ... | ... | ... | ... |
211
212## Cover Image
213
214| Option | Details |
215|--------|---------|
216| Photo cover | [Pixabay/Unsplash/Pexels search terms for wide hero image] |
217| Generated SVG | [Text-on-gradient concept with key stat, if data-heavy topic] |
218| Dimensions | 1200x630 (OG-compatible) |
219
220## Visual Element Plan
221
222| # | Type | Data | Section |
223|---|------|------|---------|
224| 1 | [Bar chart] | [Data description] | H2: Section 2 |
225| 2 | [Donut chart] | [Data description] | H2: Section 4 |
226| 3 | [Image: Pixabay] | [Search terms] | H2: Section 1 |
227| 4 | [Image: Pixabay] | [Search terms] | H2: Section 3 |
228
229## Competitive Gaps to Exploit
2301. [What competitors miss that we should cover]
2312. [Unique angle or original data we can provide]
2323. [Format advantage: charts/visuals competitors lack]
233
234## Internal Link Architecture
235- **Link TO** (from this new post to existing pages):
236 1. [Page title/URL] - anchor text: "[descriptive anchor]"
237 2. [Page title/URL] - anchor text: "[descriptive anchor]"
238 3. [Page title/URL] - anchor text: "[descriptive anchor]"
239 4. [Page title/URL] - anchor text: "[descriptive anchor]"
240 5. [Page title/URL] - anchor text: "[descriptive anchor]"
241- **Link FROM** (update these existing pages to link to this new post):
242 1. [Page title/URL] - anchor text: "[descriptive anchor]"
243 2. [Page title/URL] - anchor text: "[descriptive anchor]"
244 3. [Page title/URL] - anchor text: "[descriptive anchor]"
245 4. [Page title/URL] - anchor text: "[descriptive anchor]"
246 5. [Page title/URL] - anchor text: "[descriptive anchor]"
247- **Pillar connection**: [Which pillar page this belongs to, if applicable]
248- **Cluster position**: [Hub / Spoke / Standalone]
249
250## E-E-A-T Signals to Include
251- **Experience**: [First-hand insight, case study, or test result]
252- **Expertise**: [Author credentials relevant to topic]
253- **Authority**: [Industry recognition, citations, partnerships]
254- **Trust**: [Transparency, sourced data, no self-promotion]
255
256## Distribution Plan
257- **Reddit**: [Specific subreddits (r/sub1, r/sub2), posting approach (value-first
258 comment vs. link post), authentic participation strategy, timing]
259- **YouTube**: [Video companion concept, estimated length, key visuals from the
260 post to reuse, thumbnail idea]
261- **LinkedIn**: [Article excerpt angle, target audience segment, best posting
262 time for the niche, engagement hook]
263- **Email**: [Newsletter excerpt (2-3 sentences), subject line suggestion,
264 CTA linking back to the full post]
265- **Twitter/X**: [Thread hook (first tweet), 3-5 key tweet ideas built from
266 statistics in the post, hashtag suggestions]
267```
268
269### Step 6: Save the Brief
270
271Save to the user's project as `briefs/[slug]-brief.md` or to a location
272they specify. Confirm the brief is ready for `/blog write`.