---
name: Content Brief
slug: content-brief
category: SEO
description: Content Brief builds an SEO brief from live SERP results and your site data. Use it to plan headings, questions, and internal links before writing a page.
github: "https://github.com/Ryze-AI-Adgent/open-seo-mcp-skills/tree/main/skills/content-brief"
language: Shell
stars: 262
forks: 2
install: "npx degit https://github.com/Ryze-AI-Adgent/open-seo-mcp-skills/tree/main/skills/content-brief ~/.claude/skills/content-brief"
installs_to: ~/.claude/skills/content-brief
source_path: skills/content-brief/SKILL.md
collection_size: 8
category_size: 176
collection_url: "https://dirskills.com/collections/Ryze-AI-Adgent/open-seo-mcp-skills"
added: 2026-09-02T05:20:14.267Z
last_synced: 2026-09-02T05:20:14.267Z
canonical_url: "https://dirskills.com/skills/content-brief"
---

# Content Brief

Content Brief builds an SEO brief from live SERP results and your site data. Use it to plan headings, questions, and internal links before writing a page.

**Install:**

```bash
npx degit https://github.com/Ryze-AI-Adgent/open-seo-mcp-skills/tree/main/skills/content-brief ~/.claude/skills/content-brief
```

## README

# Content Brief

A brief grounded in the live SERP plus the site's own data — not a generic outline.

## Workflow

1. **The SERP.** If the workspace exposes DataForSEO SERP tools, pull the live Google top 10 for the target keyword (`native__get_provider_docs`, provider `dataforseo`, for the request shape) — titles, URLs, SERP features (featured snippet, PAA, video). If unavailable, fetch the top results via web search instead; the brief must be built from a real SERP either way.
2. **Read the top 3.** Fetch and skim the top-ranking pages: their structure, depth, angle, what they all cover (table stakes) and what none cover (the opening).
3. **Keyword set.** `google_ads__generateKeywordIdeas` seeded with the target — secondary keywords and question variants worth folding in, with volumes via `google_ads__generateKeywordHistoricalMetrics`.
4. **Your existing foothold.** `google_search_console__runRawSearchAnalytics` filtered to the topic — queries the site already gets impressions for (work them into headings), and existing pages on adjacent topics (internal-link sources; also flag if one already half-covers this and should be expanded instead of a new page).
5. **Assemble the brief:**
   - Target keyword + secondaries with volumes
   - Search intent and required format (guide/listicle/comparison/tool page), inferred from what actually ranks
   - Proposed title + meta (write for the CTR, under 60/155 chars)
   - H2/H3 outline with a one-line note per section on what it must say
   - Questions to answer (PAA + question keywords)
   - Table stakes vs the differentiating angle
   - Internal links: 3–5 existing pages to link from, with anchors
   - Target length: match the ranking median, don't pad

## Output

The brief, ready to hand to a writer (or to write from directly). No preamble.