Install the belt CLI skill: npx skills add belt-sh/cli
SEO Content Brief
Create data-driven content briefs via inference.sh CLI.
Quick Start
Requires inference.sh CLI (belt). Install instructions
belt login
# Research target keyword
belt app run tavily/search-assistant --input '{
"query": "best project management tools for small teams 2024"
}'
# Analyze top-ranking content
belt app run exa/search --input '{
"query": "project management tools small teams comparison guide"
}'
Content Brief Template
Every brief should answer these questions before writing begins:
# Content Brief: [Working Title]
## Target
- **Primary keyword:** [exact keyword]
- **Secondary keywords:** [3-5 related terms]
- **Search intent:** [informational / commercial / transactional / navigational]
- **Target word count:** [X,XXX words]
- **Target URL:** /blog/[slug]
## Search Intent Analysis
- What is the searcher trying to accomplish?
- What format do top results use? (listicle, guide, comparison, tutorial)
- What questions need answering?
## Outline
H1: [Title with primary keyword]
H2: [Section 1]
H3: [Subsection]
H2: [Section 2]
...
## Competitors to Beat
1. [URL] — [word count] — [what they do well] — [gap/weakness]
2. [URL] — [word count] — [what they do well] — [gap/weakness]
3. [URL] — [word count] — [what they do well] — [gap/weakness]
## Unique Angle
What makes this piece different/better than what already ranks?
## Internal Links
- Link TO: [existing pages to link to from this article]
- Link FROM: [existing pages that should link to this new article]
Search Intent Types
| Intent |
What Searcher Wants |
Content Format |
Example Query |
| Informational |
Learn something |
Guide, tutorial, explainer |
"what is CI/CD" |
| Commercial |
Compare before buying |
Comparison, listicle, review |
"best CI/CD tools 2024" |
| Transactional |
Buy/sign up |
Product page, pricing page |
"GitHub Actions pricing" |
| Navigational |
Find a specific page |
— (don't target these) |
"GitHub login" |
Match format to intent. If top 10 results are all listicles, write a listicle. If they're all tutorials, write a tutorial. Fighting the SERP format loses.
SERP Analysis Process
# Step 1: See what currently ranks
belt app run tavily/search-assistant --input '{
"query": "[your target keyword]"
}'
# Step 2: Analyze top-ranking content
belt app run tavily/extract --input '{
"urls": ["https://top-result-1.com/article", "https://top-result-2.com/article"]
}'
# Step 3: Find related questions (People Also Ask)
belt app run tavily/search-assistant --input '{
"query": "[keyword] questions people ask FAQ"
}'
# Step 4: Find content gaps
belt app run exa/search --input '{
"query": "[keyword] [subtopic competitors miss]"
}'
What to Extract from Top Results
| Data Point |
Why |
| Word count |
Sets your minimum (match or exceed top 3) |
| Heading structure |
Shows what Google considers complete coverage |
| Topics covered |
Every topic they cover, you must cover |
| Topics missed |
Your opportunity to be more comprehensive |
| Content format |
Listicle, guide, tutorial, comparison |
| Media used |
Images, videos, tables, infographics |
| Internal/external links |
Reference quality signals |
Keyword Research
Keyword Metrics
| Metric |
What It Means |
Target |
| Search volume |
Monthly searches |
Depends on niche (100+ for long-tail) |
| Keyword difficulty |
Competition level |
< 30 for new sites, < 50 for established |
| CPC |
What advertisers pay |
Higher CPC = more commercial value |
| Search intent |
What users want |
Must match your content type |
Finding Keywords
# Seed keyword research
belt app run tavily/search-assistant --input '{
"query": "project management software long tail keywords related searches"
}'
# Find question-based keywords
belt app run exa/search --input '{
"query": "questions about project management tools for startups"
}'
# Competitor keyword analysis
belt app run tavily/search-assistant --input '{
"query": "site:competitor.com/blog top performing pages topics"
}'
Keyword Clustering
Group related keywords into one piece of content:
Primary: "best project management tools for small teams"
Cluster:
- "project management software small business"
- "project management tools comparison"
- "simple project management app"
- "project management for startups"
- "affordable project management software"
One page per keyword cluster. Don't create separate pages for each variation — that's keyword cannibalization.
Heading Structure
Rules
| Rule |
Why |
| One H1 per page |
SEO standard, contains primary keyword |
| H2s = main sections |
Each should target a secondary keyword or question |
| H3s = subsections |
Break up long H2 sections |
| Primary keyword in H1 |
Direct ranking signal |
| Secondary keywords in H2s |
Topical coverage signal |
| Question format for some H2s |
Targets "People Also Ask" |
| Logical hierarchy |
Never skip levels (H1 → H3 without H2) |
Example Structure
H1: Best Project Management Tools for Small Teams (2025)
H2: How We Evaluated These Tools
H2: Top 10 Project Management Tools Compared
H3: 1. Tool A — Best for [use case]
H3: 2. Tool B — Best for [use case]
...
H2: Feature Comparison Table
H2: How to Choose the Right Tool for Your Team
H3: Team Size Considerations
H3: Budget Considerations
H2: Frequently Asked Questions
H3: What is the easiest project management tool?
H3: Do small teams need project management software?
H2: Conclusion
Word Count Targets
| Content Type |
Word Count |
When |
| Short-form blog |
800-1,200 |
News, updates, opinions |
| Standard blog |
1,500-2,000 |
How-tos, tutorials |
| Long-form guide |
2,500-4,000 |
Comprehensive guides, comparisons |
| Pillar content |
4,000-7,000 |
Definitive guides, hub pages |
| Glossary/definition |
300-800 |
Quick reference terms |
Rule: match or exceed the average word count of the top 3 ranking results. Don't pad — every word should add value.
On-Page SEO Checklist
| Element |
Rule |
| Title tag |
Primary keyword + compelling hook, 50-60 characters |
| Meta description |
Includes keyword, 150-160 characters, includes CTA |
| URL slug |
Short, keyword-rich: /best-project-management-tools |
| H1 |
Primary keyword, matches search intent |
| First 100 words |
Include primary keyword naturally |
| Image alt text |
Descriptive, includes keyword where natural |
| Internal links |
3-5 links to related content |
| External links |
2-3 authoritative sources |
| Schema markup |
FAQ, HowTo, or Article schema where applicable |
Content Differentiation
Unique Angles
| Angle |
Example |
| Original data |
"We surveyed 500 PMs — here's what they use" |
| Expert quotes |
Interview practitioners for original insights |
| Real examples |
Screenshots, case studies, not just descriptions |
| More comprehensive |
Cover subtopics competitors skip |
| More current |
Updated data, newer tools, recent changes |
| Better visuals |
Comparison tables, infographics, decision trees |
# Generate comparison infographic
belt app run infsh/html-to-image --input '{
"html": "<div style=\"width:1200px;height:800px;background:white;padding:40px;font-family:system-ui\"><h2 style=\"font-size:28px;color:#1e293b;text-align:center;margin-bottom:30px\">Project Management Tools Comparison</h2><table style=\"width:100%;border-collapse:collapse;font-size:16px\"><tr style=\"background:#f1f5f9\"><th style=\"padding:12px;text-align:left;border-bottom:2px solid #cbd5e1\">Feature</th><th style=\"padding:12px;text-align:center;border-bottom:2px solid #cbd5e1\">Tool A</th><th style=\"padding:12px;text-align:center;border-bottom:2px solid #cbd5e1\">Tool B</th><th style=\"padding:12px;text-align:center;border-bottom:2px solid #cbd5e1\">Tool C</th></tr><tr><td style=\"padding:12px;border-bottom:1px solid #e2e8f0\">Free tier</td><td style=\"padding:12px;text-align:center;border-bottom:1px solid #e2e8f0\">✅</td><td style=\"padding:12px;text-align:center;border-bottom:1px solid #e2e8f0\">✅</td><td style=\"padding:12px;text-align:center;border-bottom:1px solid #e2e8f0\">❌</td></tr></table></div>"
}'
Internal Linking Strategy
| Type |
Purpose |
| Hub → Spoke |
Pillar page links to all subtopic articles |
| Spoke → Hub |
Subtopic articles link back to pillar page |
| Spoke → Spoke |
Related articles cross-link to each other |
| Contextual |
Natural in-text links where topic is mentioned |
Rules
- 3-5 internal links minimum per article
- Anchor text should be descriptive (not "click here")
- Link to relevant pages, not random ones
- Update old articles to link to new ones
- Most important pages should have the most internal links
Common Mistakes
| Mistake |
Problem |
Fix |
| No SERP analysis |
Writing blind, wrong format |
Always analyze top 3-5 before writing |
| Wrong intent match |
Guide when they want comparison, or vice versa |
Match SERP format exactly |
| Keyword stuffing |
Penalized, reads poorly |
Use naturally, 1-2% density max |
| Ignoring "People Also Ask" |
Missing easy ranking opportunities |
Answer PAA questions in your content |
| Too short |
Can't compete with comprehensive results |
Match or exceed top 3 word count |
| No unique angle |
Just another "me too" article |
Original data, expert quotes, better visuals |
| Keyword cannibalization |
Multiple pages competing |
One page per keyword cluster |
| No internal links |
Wasted link equity, poor site structure |
3-5 internal links per article |
| Missing meta description |
Google generates one (often poorly) |
Write compelling meta with keyword + CTA |
Related Skills
npx skills add inference-sh/skills@seo
npx skills add inference-sh/skills@technical-blog-writing
npx skills add inference-sh/skills@web-search
Browse all apps: belt app list
1---
2name: seo-content-brief
3description: "SEO content brief creation with keyword research, search intent analysis, and content structure. Covers SERP analysis, heading hierarchy, word count targets, and internal linking strategy. Use for: content briefs, SEO writing, blog strategy, content planning, keyword targeting. Triggers: seo content brief, content brief, seo brief, keyword research, search intent, content strategy, blog brief, seo writing, content planning, keyword targeting, serp analysis, content outline, seo article, blog seo"
4allowed-tools: Bash(belt *)
5metadata:
6 source: https://skillmd.com/skills/101-skills/seo-content-brief
7---
8
9> **Install the belt CLI skill:** `npx skills add belt-sh/cli`
10
11# SEO Content Brief
12
13Create data-driven content briefs via [inference.sh](https://inference.sh) CLI.
14
15## Quick Start
16
17> Requires inference.sh CLI (`belt`). [Install instructions](https://raw.githubusercontent.com/inference-sh/skills/refs/heads/main/cli-install.md)
18
19```bash
20belt login
21
22# Research target keyword
23belt app run tavily/search-assistant --input '{
24 "query": "best project management tools for small teams 2024"
25}'
26
27# Analyze top-ranking content
28belt app run exa/search --input '{
29 "query": "project management tools small teams comparison guide"
30}'
31```
32
33
34## Content Brief Template
35
36Every brief should answer these questions before writing begins:
37
38```markdown
39# Content Brief: [Working Title]
40
41## Target
42- **Primary keyword:** [exact keyword]
43- **Secondary keywords:** [3-5 related terms]
44- **Search intent:** [informational / commercial / transactional / navigational]
45- **Target word count:** [X,XXX words]
46- **Target URL:** /blog/[slug]
47
48## Search Intent Analysis
49- What is the searcher trying to accomplish?
50- What format do top results use? (listicle, guide, comparison, tutorial)
51- What questions need answering?
52
53## Outline
54H1: [Title with primary keyword]
55 H2: [Section 1]
56 H3: [Subsection]
57 H2: [Section 2]
58 ...
59
60## Competitors to Beat
611. [URL] — [word count] — [what they do well] — [gap/weakness]
622. [URL] — [word count] — [what they do well] — [gap/weakness]
633. [URL] — [word count] — [what they do well] — [gap/weakness]
64
65## Unique Angle
66What makes this piece different/better than what already ranks?
67
68## Internal Links
69- Link TO: [existing pages to link to from this article]
70- Link FROM: [existing pages that should link to this new article]
71```
72
73## Search Intent Types
74
75| Intent | What Searcher Wants | Content Format | Example Query |
76|--------|-------------------|----------------|--------------|
77| **Informational** | Learn something | Guide, tutorial, explainer | "what is CI/CD" |
78| **Commercial** | Compare before buying | Comparison, listicle, review | "best CI/CD tools 2024" |
79| **Transactional** | Buy/sign up | Product page, pricing page | "GitHub Actions pricing" |
80| **Navigational** | Find a specific page | — (don't target these) | "GitHub login" |
81
82**Match format to intent.** If top 10 results are all listicles, write a listicle. If they're all tutorials, write a tutorial. Fighting the SERP format loses.
83
84## SERP Analysis Process
85
86```bash
87# Step 1: See what currently ranks
88belt app run tavily/search-assistant --input '{
89 "query": "[your target keyword]"
90}'
91
92# Step 2: Analyze top-ranking content
93belt app run tavily/extract --input '{
94 "urls": ["https://top-result-1.com/article", "https://top-result-2.com/article"]
95}'
96
97# Step 3: Find related questions (People Also Ask)
98belt app run tavily/search-assistant --input '{
99 "query": "[keyword] questions people ask FAQ"
100}'
101
102# Step 4: Find content gaps
103belt app run exa/search --input '{
104 "query": "[keyword] [subtopic competitors miss]"
105}'
106```
107
108### What to Extract from Top Results
109
110| Data Point | Why |
111|-----------|-----|
112| **Word count** | Sets your minimum (match or exceed top 3) |
113| **Heading structure** | Shows what Google considers complete coverage |
114| **Topics covered** | Every topic they cover, you must cover |
115| **Topics missed** | Your opportunity to be more comprehensive |
116| **Content format** | Listicle, guide, tutorial, comparison |
117| **Media used** | Images, videos, tables, infographics |
118| **Internal/external links** | Reference quality signals |
119
120## Keyword Research
121
122### Keyword Metrics
123
124| Metric | What It Means | Target |
125|--------|--------------|--------|
126| **Search volume** | Monthly searches | Depends on niche (100+ for long-tail) |
127| **Keyword difficulty** | Competition level | < 30 for new sites, < 50 for established |
128| **CPC** | What advertisers pay | Higher CPC = more commercial value |
129| **Search intent** | What users want | Must match your content type |
130
131### Finding Keywords
132
133```bash
134# Seed keyword research
135belt app run tavily/search-assistant --input '{
136 "query": "project management software long tail keywords related searches"
137}'
138
139# Find question-based keywords
140belt app run exa/search --input '{
141 "query": "questions about project management tools for startups"
142}'
143
144# Competitor keyword analysis
145belt app run tavily/search-assistant --input '{
146 "query": "site:competitor.com/blog top performing pages topics"
147}'
148```
149
150### Keyword Clustering
151
152Group related keywords into one piece of content:
153
154```
155Primary: "best project management tools for small teams"
156Cluster:
157 - "project management software small business"
158 - "project management tools comparison"
159 - "simple project management app"
160 - "project management for startups"
161 - "affordable project management software"
162```
163
164**One page per keyword cluster.** Don't create separate pages for each variation — that's keyword cannibalization.
165
166## Heading Structure
167
168### Rules
169
170| Rule | Why |
171|------|-----|
172| One H1 per page | SEO standard, contains primary keyword |
173| H2s = main sections | Each should target a secondary keyword or question |
174| H3s = subsections | Break up long H2 sections |
175| Primary keyword in H1 | Direct ranking signal |
176| Secondary keywords in H2s | Topical coverage signal |
177| Question format for some H2s | Targets "People Also Ask" |
178| Logical hierarchy | Never skip levels (H1 → H3 without H2) |
179
180### Example Structure
181
182```
183H1: Best Project Management Tools for Small Teams (2025)
184 H2: How We Evaluated These Tools
185 H2: Top 10 Project Management Tools Compared
186 H3: 1. Tool A — Best for [use case]
187 H3: 2. Tool B — Best for [use case]
188 ...
189 H2: Feature Comparison Table
190 H2: How to Choose the Right Tool for Your Team
191 H3: Team Size Considerations
192 H3: Budget Considerations
193 H2: Frequently Asked Questions
194 H3: What is the easiest project management tool?
195 H3: Do small teams need project management software?
196 H2: Conclusion
197```
198
199## Word Count Targets
200
201| Content Type | Word Count | When |
202|-------------|-----------|------|
203| Short-form blog | 800-1,200 | News, updates, opinions |
204| Standard blog | 1,500-2,000 | How-tos, tutorials |
205| Long-form guide | 2,500-4,000 | Comprehensive guides, comparisons |
206| Pillar content | 4,000-7,000 | Definitive guides, hub pages |
207| Glossary/definition | 300-800 | Quick reference terms |
208
209**Rule: match or exceed the average word count of the top 3 ranking results.** Don't pad — every word should add value.
210
211## On-Page SEO Checklist
212
213| Element | Rule |
214|---------|------|
215| **Title tag** | Primary keyword + compelling hook, 50-60 characters |
216| **Meta description** | Includes keyword, 150-160 characters, includes CTA |
217| **URL slug** | Short, keyword-rich: `/best-project-management-tools` |
218| **H1** | Primary keyword, matches search intent |
219| **First 100 words** | Include primary keyword naturally |
220| **Image alt text** | Descriptive, includes keyword where natural |
221| **Internal links** | 3-5 links to related content |
222| **External links** | 2-3 authoritative sources |
223| **Schema markup** | FAQ, HowTo, or Article schema where applicable |
224
225## Content Differentiation
226
227### Unique Angles
228
229| Angle | Example |
230|-------|---------|
231| **Original data** | "We surveyed 500 PMs — here's what they use" |
232| **Expert quotes** | Interview practitioners for original insights |
233| **Real examples** | Screenshots, case studies, not just descriptions |
234| **More comprehensive** | Cover subtopics competitors skip |
235| **More current** | Updated data, newer tools, recent changes |
236| **Better visuals** | Comparison tables, infographics, decision trees |
237
238```bash
239# Generate comparison infographic
240belt app run infsh/html-to-image --input '{
241 "html": "<div style=\"width:1200px;height:800px;background:white;padding:40px;font-family:system-ui\"><h2 style=\"font-size:28px;color:#1e293b;text-align:center;margin-bottom:30px\">Project Management Tools Comparison</h2><table style=\"width:100%;border-collapse:collapse;font-size:16px\"><tr style=\"background:#f1f5f9\"><th style=\"padding:12px;text-align:left;border-bottom:2px solid #cbd5e1\">Feature</th><th style=\"padding:12px;text-align:center;border-bottom:2px solid #cbd5e1\">Tool A</th><th style=\"padding:12px;text-align:center;border-bottom:2px solid #cbd5e1\">Tool B</th><th style=\"padding:12px;text-align:center;border-bottom:2px solid #cbd5e1\">Tool C</th></tr><tr><td style=\"padding:12px;border-bottom:1px solid #e2e8f0\">Free tier</td><td style=\"padding:12px;text-align:center;border-bottom:1px solid #e2e8f0\">✅</td><td style=\"padding:12px;text-align:center;border-bottom:1px solid #e2e8f0\">✅</td><td style=\"padding:12px;text-align:center;border-bottom:1px solid #e2e8f0\">❌</td></tr></table></div>"
242}'
243```
244
245## Internal Linking Strategy
246
247| Type | Purpose |
248|------|---------|
249| **Hub → Spoke** | Pillar page links to all subtopic articles |
250| **Spoke → Hub** | Subtopic articles link back to pillar page |
251| **Spoke → Spoke** | Related articles cross-link to each other |
252| **Contextual** | Natural in-text links where topic is mentioned |
253
254### Rules
255
256- 3-5 internal links minimum per article
257- Anchor text should be descriptive (not "click here")
258- Link to relevant pages, not random ones
259- Update old articles to link to new ones
260- Most important pages should have the most internal links
261
262## Common Mistakes
263
264| Mistake | Problem | Fix |
265|---------|---------|-----|
266| No SERP analysis | Writing blind, wrong format | Always analyze top 3-5 before writing |
267| Wrong intent match | Guide when they want comparison, or vice versa | Match SERP format exactly |
268| Keyword stuffing | Penalized, reads poorly | Use naturally, 1-2% density max |
269| Ignoring "People Also Ask" | Missing easy ranking opportunities | Answer PAA questions in your content |
270| Too short | Can't compete with comprehensive results | Match or exceed top 3 word count |
271| No unique angle | Just another "me too" article | Original data, expert quotes, better visuals |
272| Keyword cannibalization | Multiple pages competing | One page per keyword cluster |
273| No internal links | Wasted link equity, poor site structure | 3-5 internal links per article |
274| Missing meta description | Google generates one (often poorly) | Write compelling meta with keyword + CTA |
275
276## Related Skills
277
278```bash
279npx skills add inference-sh/skills@seo
280npx skills add inference-sh/skills@technical-blog-writing
281npx skills add inference-sh/skills@web-search
282```
283
284Browse all apps: `belt app list`
285