Content brief skill

SERP-driven content brief for a target keyword — what ranks, what to cover, headings, questions, internal links from your own data.

by Ryze-AI-Adgent·MIT license·★ 3,135 Stars on the repo·GitHub ↗

Use now

Files of Content brief

Ryze-AI-Adgent/main1 file shown
SKILL.md
Show the full text33 lines
content-brief/SKILL.md33 lines · 2.4 KB

Content Brief

Requires

The free Ryze MCP connector (https://connector.get-ryze.ai/mcp). Claude Code: claude mcp add ryze --transport http https://connector.get-ryze.ai/mcp. claude.ai / Desktop / Cursor: add it as a custom connector with the same URL. Setup: https://www.get-ryze.ai/how-to-connect-claude-to-google-meta-ads-mcp

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.

1---
2name: content-brief
3description: SERP-driven content brief for a target keyword — what ranks, what to cover, headings, questions, internal links from your own data. Use when asked for a "content brief", "outline to rank for X", "what should this article cover", or before writing any SEO page.
4---
5 
6# Content Brief
7 
8## Requires
9 
10The free Ryze MCP connector (`https://connector.get-ryze.ai/mcp`). Claude Code: `claude mcp add ryze --transport http https://connector.get-ryze.ai/mcp`. claude.ai / Desktop / Cursor: add it as a custom connector with the same URL. Setup: https://www.get-ryze.ai/how-to-connect-claude-to-google-meta-ads-mcp
11 
12A brief grounded in the live SERP plus the site's own data — not a generic outline.
13 
14## Workflow
15 
161. **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.
172. **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).
183. **Keyword set.** `google_ads__generateKeywordIdeas` seeded with the target — secondary keywords and question variants worth folding in, with volumes via `google_ads__generateKeywordHistoricalMetrics`.
194. **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).
205. **Assemble the brief:**
21 - Target keyword + secondaries with volumes
22 - Search intent and required format (guide/listicle/comparison/tool page), inferred from what actually ranks
23 - Proposed title + meta (write for the CTR, under 60/155 chars)
24 - H2/H3 outline with a one-line note per section on what it must say
25 - Questions to answer (PAA + question keywords)
26 - Table stakes vs the differentiating angle
27 - Internal links: 3–5 existing pages to link from, with anchors
28 - Target length: match the ranking median, don't pad
29 
30## Output
31 
32The brief, ready to hand to a writer (or to write from directly). No preamble.
33 

Discussion

Alternatives

Agentic Browsing ReadinessAudit and fix agent readiness: the Lighthouse Agentic Browsing fraction, accessibility tree for agents, robots.txt and Content-Signal for AI agents, WAF treatment of agent traffic, llms.txt, Markdown delivery, ai-catalog.json, /.well-known discovery files, and WebMCP tools. Exclude AI citability and brand signals (seo-geo) and commerce protocol depth (seo-ecommerce).Marketing · MITBacklink Profile AnalysisBacklink profile analysis: referring domains, anchor text distribution, toxic link detection, competitor gap analysis. Works with free APIs (Moz, Bing Webmaster, Common Crawl) and DataForSEO extension. Use when user says backlinks, link profile, referring domains, anchor text, toxic links, link gap, link building, disavow, or backlink audit.Marketing · MIT/setup-cmsConnect a CMS to notfair SEO tools. Guides users through configuring WordPress, Strapi, Contentful, or Ghost — tests the connection, and writes credentials to .env.local. Once set up, seo-analysis automatically cross- references CMS content against Google Search Console data. Use whenever the user says "connect my CMS", "set up WordPress", "configure Strapi", "add Contentful", "connect Ghost", or "CMS setup". Also trigger if the user asks why no CMS data appears in a seo-analysis report. · MITBacklink checkBacklink profile for any domain — referring domains, authority, anchors, new/lost links, and a side-by-side vs a competitor. Use when asked "check my backlinks", "backlink profile of X", "who links to them", or "link gap vs competitor".Marketing · MIT