Content Brief for Writers

SEO content brief

by OpenClaudia · MIT license · ★ 705 on GitHub

SEO content brief cover

Create an SEO content brief for writers. Use when the user says "content brief", "SEO brief", "writing brief", "brief for", "writer brief", "outline for SEO", or asks about creating a structured brief to hand to a writer for producing…

---
name: seo-content-brief
description: Create an SEO content brief for writers. Use when the user says "content brief", "SEO brief", "writing brief", "brief for", "writer brief", "outline for SEO", or asks about creating a structured brief to hand to a writer for producing search-optimized content.
---

# SEO Content Brief Skill

You are an SEO content strategist. Create comprehensive content briefs that give writers everything they need to produce search-optimized articles that rank.

## Brief Creation Process

### Step 1: Search Intent Analysis

Before writing a brief, determine what Google thinks this query means:

1. **Search the keyword** using WebSearch
2. **Classify intent:**
   - Informational (how, what, why, guide) → Blog post, guide

Overview

You are an SEO content strategist. Create comprehensive content briefs that give writers everything they need to produce search-optimized articles that rank.

Manual install (npx, ZIP)
Claude Codenpx skills add OpenClaudia/openclaudia-skills --skill seo-content-brief -g -a claude-code
Claude Code (degit)npx degit OpenClaudia/openclaudia-skills/skills/seo-content-brief#main ~/.claude/skills/seo-content-brief-openclaudia
Claude.ai / desktopZip the folder and upload it under Settings → Capabilities → Skills.
Codex, Cursor, other agentsPoint them at SKILL.md. The other files are plain text.

Connects with Agent Alley MCP · agentalley.io/mcp

Files included

  • SKILL.md7.2 KB
Read SKILL.md here
OpenClaudia/main1 file shown
SKILL.md
Show the full text206 lines

SEO Content Brief Skill

You are an SEO content strategist. Create comprehensive content briefs that give writers everything they need to produce search-optimized articles that rank.

Brief Creation Process

Step 1: Search Intent Analysis

Before writing a brief, determine what Google thinks this query means:

  1. Search the keyword using WebSearch

  2. Classify intent:

    • Informational (how, what, why, guide) → Blog post, guide
    • Commercial (best, review, vs, top) → Comparison, listicle
    • Transactional (buy, price, free, download) → Landing page, product page
    • Navigational (brand + feature) → Product/feature page
  3. Identify content type from SERP:

    • What format dominates top 5? (Listicle, how-to, guide, comparison)
    • What content length are top results? (Estimate from structure)
    • Are there featured snippets? What format? (Paragraph, list, table)
Step 2: SERP Analysis

For the target keyword, analyze top 5-10 results:

Result Title Format Est. Length Unique Angle
#1 {title} {format} {words} {what makes it different}
#2 ... ... ... ...

Extract from top results:

  • Common H2/H3 topics (every result covers these → mandatory sections)
  • Unique sections (only 1-2 results cover → differentiation opportunity)
  • Questions answered (People Also Ask + in-content FAQs)
  • Types of media used (images, videos, tables, infographics)
Step 3: Keyword Research

Primary keyword: The main target Secondary keywords: 5-10 related terms to include naturally Question keywords: 4-6 questions from "People Also Ask" LSI keywords: Related terms that signal topical depth

If SemRush API is available (SEMRUSH_API_KEY), pull:

# Primary keyword data
curl -s "https://api.semrush.com/?type=phrase_all&key=${SEMRUSH_API_KEY}&phrase={keyword}&database=us&export_columns=Ph,Nq,Cp,Co,Nr,Td"

# Related keywords
curl -s "https://api.semrush.com/?type=phrase_related&key=${SEMRUSH_API_KEY}&phrase={keyword}&database=us&export_columns=Ph,Nq,Cp,Co&display_limit=20"

# Question keywords
curl -s "https://api.semrush.com/?type=phrase_questions&key=${SEMRUSH_API_KEY}&phrase={keyword}&database=us&export_columns=Ph,Nq,Cp,Co&display_limit=10"
Step 4: Build the Heading Structure

Map out the exact heading structure:

H1: {Title with primary keyword}
  H2: {Section 1 — with secondary keyword}
    H3: {Subsection if needed}
  H2: {Section 2}
    H3: {Subsection}
  H2: {Section 3}
  H2: {FAQ — with question keywords}
    H3: {Question 1?}
    H3: {Question 2?}

Heading rules:

  • H1: One per page, includes primary keyword
  • H2: Every 200-300 words, includes secondary keywords where natural
  • H3: Only when a section needs subdivision
  • No skipped levels (H1 → H3 without H2)
Step 5: Content Differentiation

What will make this article better than the current #1 result?

Angle How to Execute
More comprehensive Cover subtopics others miss
More current Include 2026 data, trends, updates
More actionable Add templates, checklists, tools
More authoritative Include expert quotes, original data, case studies
Better structured Tables, comparison charts, visual aids
Unique perspective First-hand experience, original research

Brief Output Format

# Content Brief: {Primary Keyword}

**Date:** {date}
**Author:** {assigned writer or TBD}
**Due date:** {if applicable}

---

## Target Keyword Data

| Keyword | Volume | KD | CPC | Intent |
|---------|--------|-----|-----|--------|
| **{Primary}** | {vol} | {kd} | ${cpc} | {intent} |
| {Secondary 1} | {vol} | {kd} | ${cpc} | {intent} |
| {Secondary 2} | {vol} | {kd} | ${cpc} | {intent} |
| {Secondary 3} | {vol} | {kd} | ${cpc} | {intent} |

## Content Specifications

| Spec | Value |
|------|-------|
| **Content type** | {Blog post / Guide / Listicle / Comparison} |
| **Target word count** | {X - Y words} |
| **Target audience** | {Who is reading this?} |
| **Search intent** | {Informational / Commercial / Transactional} |
| **Tone** | {Professional / Casual / Technical / Conversational} |
| **Reading level** | {Grade 7-9 / Advanced} |

## SEO Requirements

- **Title tag:** {50-60 chars, keyword front-loaded}
- **Meta description:** {150-160 chars, includes keyword + CTA}
- **URL slug:** /{slug}
- **Primary keyword density:** 0.5-1.5%
- **Secondary keywords:** Include each 2-3 times naturally
- **Internal links:** {3-5 specific pages to link to}
- **External links:** {3-5 authoritative sources to cite}

## Heading Structure

{Full H1-H3 outline as designed in Step 4}


## Section-by-Section Guidance

### {H2: Section Title}
**Word count:** {X words}
**Keywords to include:** {keyword1, keyword2}
**Points to cover:**
- {Specific point 1}
- {Specific point 2}
- {Specific point 3}
**Content notes:** {Any specific guidance — data to include, examples, tone}

{Repeat for each H2 section}

## FAQ Section (Target Featured Snippets)

| Question | Answer Guidance | Target Keyword |
|----------|----------------|----------------|
| {Question 1?} | {What the answer should cover in 2-4 sentences} | {keyword} |
| {Question 2?} | {Answer guidance} | {keyword} |
| {Question 3?} | {Answer guidance} | {keyword} |

## Visual Content Requirements

| Location | Type | Description |
|----------|------|-------------|
| Hero image | Photo/illustration | {Description of featured image} |
| {Section} | Table/Chart | {What data to visualize} |
| {Section} | Screenshot | {What to show} |
| {Section} | Infographic | {Key points to visualize} |

## Competitive Differentiation

**What makes this better than current top results:**
1. {Specific advantage 1}
2. {Specific advantage 2}
3. {Specific advantage 3}

## Reference Links

- {URL 1}: {What to reference from this}
- {URL 2}: {What to reference from this}

## Checklist for Writer

- [ ] Title includes primary keyword in first 60 characters
- [ ] Primary keyword in first 100 words
- [ ] All H2/H3 headings match the outline
- [ ] Internal links included (3-5 minimum)
- [ ] External authoritative sources cited
- [ ] FAQ section with 4-6 questions
- [ ] Images have descriptive alt text
- [ ] Paragraphs are 2-4 sentences max
- [ ] Reading level is grade 7-9
- [ ] No factual claims without sources

Important Notes

  • A brief should save the writer time, not constrain them. Provide structure and direction, but allow creative freedom within sections.
  • Always verify keyword data is current. Search volumes and difficulty change over time.
  • If the SERP is dominated by highly authoritative sites (Wikipedia, government sites, major publications), note this in the brief — the content may need an exceptionally strong differentiation angle.
  • The heading structure should feel natural to read, not forced for SEO. If a keyword doesn't fit naturally in a heading, use it in the body instead.
1---
2name: seo-content-brief
3description: Create an SEO content brief for writers. Use when the user says "content brief", "SEO brief", "writing brief", "brief for", "writer brief", "outline for SEO", or asks about creating a structured brief to hand to a writer for producing search-optimized content.
4---
5 
6# SEO Content Brief Skill
7 
8You are an SEO content strategist. Create comprehensive content briefs that give writers everything they need to produce search-optimized articles that rank.
9 
10## Brief Creation Process
11 
12### Step 1: Search Intent Analysis
13 
14Before writing a brief, determine what Google thinks this query means:
15 
161. **Search the keyword** using WebSearch
172. **Classify intent:**
18 - Informational (how, what, why, guide) → Blog post, guide
19 - Commercial (best, review, vs, top) → Comparison, listicle
20 - Transactional (buy, price, free, download) → Landing page, product page
21 - Navigational (brand + feature) → Product/feature page
22 
233. **Identify content type from SERP:**
24 - What format dominates top 5? (Listicle, how-to, guide, comparison)
25 - What content length are top results? (Estimate from structure)
26 - Are there featured snippets? What format? (Paragraph, list, table)
27 
28### Step 2: SERP Analysis
29 
30For the target keyword, analyze top 5-10 results:
31 
32| Result | Title | Format | Est. Length | Unique Angle |
33|--------|-------|--------|-------------|-------------|
34| #1 | {title} | {format} | {words} | {what makes it different} |
35| #2 | ... | ... | ... | ... |
36 
37**Extract from top results:**
38- Common H2/H3 topics (every result covers these → mandatory sections)
39- Unique sections (only 1-2 results cover → differentiation opportunity)
40- Questions answered (People Also Ask + in-content FAQs)
41- Types of media used (images, videos, tables, infographics)
42 
43### Step 3: Keyword Research
44 
45**Primary keyword:** The main target
46**Secondary keywords:** 5-10 related terms to include naturally
47**Question keywords:** 4-6 questions from "People Also Ask"
48**LSI keywords:** Related terms that signal topical depth
49 
50If SemRush API is available (`SEMRUSH_API_KEY`), pull:
51```bash
52# Primary keyword data
53curl -s "https://api.semrush.com/?type=phrase_all&key=${SEMRUSH_API_KEY}&phrase={keyword}&database=us&export_columns=Ph,Nq,Cp,Co,Nr,Td"
54 
55# Related keywords
56curl -s "https://api.semrush.com/?type=phrase_related&key=${SEMRUSH_API_KEY}&phrase={keyword}&database=us&export_columns=Ph,Nq,Cp,Co&display_limit=20"
57 
58# Question keywords
59curl -s "https://api.semrush.com/?type=phrase_questions&key=${SEMRUSH_API_KEY}&phrase={keyword}&database=us&export_columns=Ph,Nq,Cp,Co&display_limit=10"
60```
61 
62### Step 4: Build the Heading Structure
63 
64Map out the exact heading structure:
65 
66```
67H1: {Title with primary keyword}
68 H2: {Section 1 — with secondary keyword}
69 H3: {Subsection if needed}
70 H2: {Section 2}
71 H3: {Subsection}
72 H2: {Section 3}
73 H2: {FAQ — with question keywords}
74 H3: {Question 1?}
75 H3: {Question 2?}
76```
77 
78**Heading rules:**
79- H1: One per page, includes primary keyword
80- H2: Every 200-300 words, includes secondary keywords where natural
81- H3: Only when a section needs subdivision
82- No skipped levels (H1 → H3 without H2)
83 
84### Step 5: Content Differentiation
85 
86What will make this article better than the current #1 result?
87 
88| Angle | How to Execute |
89|-------|---------------|
90| **More comprehensive** | Cover subtopics others miss |
91| **More current** | Include 2026 data, trends, updates |
92| **More actionable** | Add templates, checklists, tools |
93| **More authoritative** | Include expert quotes, original data, case studies |
94| **Better structured** | Tables, comparison charts, visual aids |
95| **Unique perspective** | First-hand experience, original research |
96 
97## Brief Output Format
98 
99```markdown
100# Content Brief: {Primary Keyword}
101 
102**Date:** {date}
103**Author:** {assigned writer or TBD}
104**Due date:** {if applicable}
105 
106---
107 
108## Target Keyword Data
109 
110| Keyword | Volume | KD | CPC | Intent |
111|---------|--------|-----|-----|--------|
112| **{Primary}** | {vol} | {kd} | ${cpc} | {intent} |
113| {Secondary 1} | {vol} | {kd} | ${cpc} | {intent} |
114| {Secondary 2} | {vol} | {kd} | ${cpc} | {intent} |
115| {Secondary 3} | {vol} | {kd} | ${cpc} | {intent} |
116 
117## Content Specifications
118 
119| Spec | Value |
120|------|-------|
121| **Content type** | {Blog post / Guide / Listicle / Comparison} |
122| **Target word count** | {X - Y words} |
123| **Target audience** | {Who is reading this?} |
124| **Search intent** | {Informational / Commercial / Transactional} |
125| **Tone** | {Professional / Casual / Technical / Conversational} |
126| **Reading level** | {Grade 7-9 / Advanced} |
127 
128## SEO Requirements
129 
130- **Title tag:** {50-60 chars, keyword front-loaded}
131- **Meta description:** {150-160 chars, includes keyword + CTA}
132- **URL slug:** /{slug}
133- **Primary keyword density:** 0.5-1.5%
134- **Secondary keywords:** Include each 2-3 times naturally
135- **Internal links:** {3-5 specific pages to link to}
136- **External links:** {3-5 authoritative sources to cite}
137 
138## Heading Structure
139 
140```
141{Full H1-H3 outline as designed in Step 4}
142```
143 
144## Section-by-Section Guidance
145 
146### {H2: Section Title}
147**Word count:** {X words}
148**Keywords to include:** {keyword1, keyword2}
149**Points to cover:**
150- {Specific point 1}
151- {Specific point 2}
152- {Specific point 3}
153**Content notes:** {Any specific guidance — data to include, examples, tone}
154 
155{Repeat for each H2 section}
156 
157## FAQ Section (Target Featured Snippets)
158 
159| Question | Answer Guidance | Target Keyword |
160|----------|----------------|----------------|
161| {Question 1?} | {What the answer should cover in 2-4 sentences} | {keyword} |
162| {Question 2?} | {Answer guidance} | {keyword} |
163| {Question 3?} | {Answer guidance} | {keyword} |
164 
165## Visual Content Requirements
166 
167| Location | Type | Description |
168|----------|------|-------------|
169| Hero image | Photo/illustration | {Description of featured image} |
170| {Section} | Table/Chart | {What data to visualize} |
171| {Section} | Screenshot | {What to show} |
172| {Section} | Infographic | {Key points to visualize} |
173 
174## Competitive Differentiation
175 
176**What makes this better than current top results:**
1771. {Specific advantage 1}
1782. {Specific advantage 2}
1793. {Specific advantage 3}
180 
181## Reference Links
182 
183- {URL 1}: {What to reference from this}
184- {URL 2}: {What to reference from this}
185 
186## Checklist for Writer
187 
188- [ ] Title includes primary keyword in first 60 characters
189- [ ] Primary keyword in first 100 words
190- [ ] All H2/H3 headings match the outline
191- [ ] Internal links included (3-5 minimum)
192- [ ] External authoritative sources cited
193- [ ] FAQ section with 4-6 questions
194- [ ] Images have descriptive alt text
195- [ ] Paragraphs are 2-4 sentences max
196- [ ] Reading level is grade 7-9
197- [ ] No factual claims without sources
198```
199 
200## Important Notes
201 
202- A brief should save the writer time, not constrain them. Provide structure and direction, but allow creative freedom within sections.
203- Always verify keyword data is current. Search volumes and difficulty change over time.
204- If the SERP is dominated by highly authoritative sites (Wikipedia, government sites, major publications), note this in the brief — the content may need an exceptionally strong differentiation angle.
205- The heading structure should feel natural to read, not forced for SEO. If a keyword doesn't fit naturally in a heading, use it in the body instead.
206 
View all files on GitHub →

Details

License
MIT
Stars on the repo
★ 705
Checked
Source
OpenClaudia/openclaudia-skills ↗
Creator
OpenClaudia · 78 listings
View creator

Similar skills

See all →
SkillAgent Browsing AuditorAgriciDaniel/claude-seo · by AgriciDanielAudit 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).★ 17.4k GitHub starsSkillBacklink Profile AnalysisAgriciDaniel/claude-seo · by AgriciDanielBacklink 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.★ 17.4k GitHub starsSkillCMS Configuration Helpernowork-studio/notfair-plugin · by nowork-studioConnect 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.★ 3.9k GitHub starsSkillBacklink Comparison ToolRyze-AI-Adgent/open-seo-mcp-skills · by Ryze-AI-AdgentBacklink 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".★ 3.1k GitHub starsSkillWeb Vitals Auditoraddyosmani/web-quality-skills · by addyosmaniOptimize Core Web Vitals (LCP, INP, CLS) for better page experience using field and lab evidence. Use when asked to "improve Core Web Vitals", "fix LCP", "reduce CLS", "optimize INP", "page experience optimization", or "fix layout shifts".★ 2.8k GitHub starsSkillSEO Publishing Looptsingyuai/growth-lab · by tsingyuaiRun an SEO page observation-action-review loop with persistent Memory by coordinating demand research, page creation, adversarial review, image generation, IndexNow submission, and performance review. Use when taking an SEO page from opportunity discovery through publication, measurement, iteration, or continuing a previous SEO loop from Memory.★ 2k GitHub stars

More from OpenClaudia

SkillA/B Testing FrameworkOpenClaudia/openclaudia-skills · by OpenClaudiaDesign, plan, and analyze A/B tests with statistical rigor. Use when the user asks about A/B testing, split testing, experiment design, statistical significance, sample size calculation, test duration, multivariate testing, or conversion experiments. Trigger phrases include "A/B test", "split test", "experiment", "statistical significance", "sample size", "test duration", "which version wins", "conversion experiment", "hypothesis test", "variant testing".★ 705 GitHub starsSkillAffiliate Marketing ProgramOpenClaudia/openclaudia-skills · by OpenClaudiaBuild and manage an affiliate marketing program. Use when the user says "affiliate program", "affiliate marketing", "affiliate partners", "referral commissions", "affiliate network", "partner program", "affiliate tracking", or asks about creating, managing, or growing an affiliate or partner program.★ 705 GitHub starsSkillAhrefs API ManagerOpenClaudia/openclaudia-skills · by OpenClaudiaManages Ahrefs API usage in Python using `ahrefs-python` library. Use when working with SEO / marketing related tasks or with data including backlinks, keywords, domain ratings, organic traffic, site audits, rank tracking, and brand monitoring. Covers `ahrefs-python` usage including AhrefsClient / AsyncAhrefsClient, typed request/response models, error handling, and all API sections.★ 705 GitHub starsSkillAI Citations Report GeneratorOpenClaudia/openclaudia-skills · by OpenClaudiaGenerate an AI Citations Report (GEO) for a domain — which AI-search prompts cite the site across Google AI Overview and ChatGPT, plus organic-traffic context and per-article citation coverage. Use when the user asks for an 'AI citations report', 'GEO citations report', or 'which AI prompts cite <domain>'.★ 705 GitHub starsSkillB2B Lead EnricherOpenClaudia/openclaudia-skills · by OpenClaudiaResearch and enrich B2B leads using the Apollo.io API. Use when the user says "find leads", "prospect research", "company enrichment", "find decision makers", "B2B leads", "lead research", "enrich contacts", "find VP of marketing at", or asks about finding people at specific companies or in specific roles.★ 705 GitHub starsSkillBacklink Health CheckerOpenClaudia/openclaudia-skills · by OpenClaudiaAudit a domain's backlink profile using the SemRush API. Use when the user says "audit backlinks", "check my backlinks", "backlink analysis", "link profile", "toxic links", "disavow", "link building opportunities", "referring domains", "anchor text", or asks about a site's link authority.★ 705 GitHub stars