Seo Content Brief

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

bashCopy code
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:

markdownCopy code
# 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

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

bashCopy code
# 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

Keyword Research

Keyword Metrics

Finding Keywords

bashCopy code
# 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:

Copy code
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

Example Structure

Copy code
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

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

Content Differentiation

Unique Angles

bashCopy code
# 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

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

Related Skills

bashCopy code
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