Agent skill

SEO Content Brief

by OpenClaudia in OpenClaudia/openclaudia-skills

Create an SEO content brief for writers. An agent skill from OpenClaudia/openclaudia-skills.

MITAuto-check passedMarketing & SEO

Install SEO Content Brief

skills CLI
$ npx skills add OpenClaudia/openclaudia-skills --skill seo-content-brief -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install OpenClaudia/openclaudia-skills seo-content-brief --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/OpenClaudia/openclaudia-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/seo-content-brief .claude/skills/seo-content-brief && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
seo-content-brief
GitHub stars
713
Token cost
~1.8k tokens
SKILL.md length
425 words
Files
1
Skills in repo
74
Repo updated
First seen
Licence
MIT

At a glance

Create an SEO content brief for writers. An agent skill from OpenClaudia/openclaudia-skills.

  • Works in 5 steps: Search Intent Analysis → SERP Analysis → Keyword Research → …
  • The user says content brief
  • SKILL.md covers Brief Creation Process, Brief Output Format and Important Notes
  • Calls curl; reaches api.semrush.com; needs SEMRUSH_API_KEY

What it does

SEO Content Brief is an agent skill from OpenClaudia/openclaudia-skills. 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.

Its SKILL.md is about 1.8k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Marketing & SEO, covering On-page SEO and Content strategy. The repository describes itself as: 77 open-source marketing skills for Claude Code, Codex, and other AI coding agents. SEO, content, email, ads, analytics, and growth. The licence is MIT.

When your agent uses it

  • The user says content brief
  • Outline for SEO
  • Asks about creating a structured brief to hand to a writer for producing search-optimized content

Example prompts

  • “content brief”
  • “SEO brief”
  • “writing brief”
  • “/seo-content-brief”

Requirements

  • A credential in SEMRUSH_API_KEY

Workflow steps

5 steps, taken from the step headings in SKILL.md.

  1. Search Intent Analysis
  2. SERP Analysis
  3. Keyword Research
  4. Build the Heading Structure
  5. Content Differentiation

What it can do on your machine

Read from SKILL.md and the folder at commit 28bf209. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • curl

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • api.semrush.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • SEMRUSH_API_KEY

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

SEO Content Brief loads about 1.8k tokens when it runs. Until then it costs about 70 tokens; SKILL.md has 425 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~70
When it runs · the whole SKILL.md, loaded when a task matches
~1.8k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from OpenClaudia/openclaudia-skills at commit 28bf209, republished under its MIT licence (© OpenClaudia). 425 words, ~1,831 tokens.

Download SKILL.mdSave it as .claude/skills/seo-content-brief/SKILL.md (or your agent's skills folder).
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
    • 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:

ResultTitleFormatEst. LengthUnique 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:

bash
# 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)
Show full SKILL.md (161 more words)Show less
Step 5: Content Differentiation

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

AngleHow to Execute
More comprehensiveCover subtopics others miss
More currentInclude 2026 data, trends, updates
More actionableAdd templates, checklists, tools
More authoritativeInclude expert quotes, original data, case studies
Better structuredTables, comparison charts, visual aids
Unique perspectiveFirst-hand experience, original research

Brief Output Format

markdown
# 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.

© OpenClaudia, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/seo-content-brief of OpenClaudia/openclaudia-skills.

Open the folder on GitHubat commit 28bf209

Compare with similar skills

SEO Content Brief next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

SEO Content Brief compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
SEO Content Brief this skillOpenClaudia/openclaudia-skills713—~1.8kAutomated safety check: PassMIT
SEO Keyword ClusteringAgriciDaniel/claude-seo19k2 repos~3.3kAutomated safety check: PassMIT
SEO Content Brief GeneratorAgriciDaniel/claude-seo19k2 repos~2.6kAutomated safety check: PassMIT
E2E SEO Assistantirinabuht12-oss/marketing-skills4.1k—~1.9kAutomated safety check: PassNone
SEO Content Briefseranking/seo-skills161—~2.5kAutomated safety check: PassMIT
Blog OutlineAgriciDaniel/claude-blog2.3k1 repos~1.5kAutomated safety check: PassMIT

Similar skills

  • SEO Keyword Clustering

    AgriciDaniel/claude-seo

    Clusters keywords by how much their search results overlap and designs a hub-and-spoke content plan with an internal link matrix and an interactive cluster map.

    19k GitHub starsUsed in 2 repos~3.3k tokens
    Marketing & SEOAuto-check passed
  • SEO Content Brief Generator

    AgriciDaniel/claude-seo

    Builds research-backed SEO content briefs with competitor scoring, per-section word counts and page-type templates, for new pages or improving existing ones.

    19k GitHub starsUsed in 2 repos~2.6k tokens
    Marketing & SEOAuto-check passed
  • E2E SEO Assistant

    irinabuht12-oss/marketing-skills

    Full SEO workflow covering technical audits, content gaps, backlink opportunities, on-page fixes, and content briefs.

    4.1k GitHub stars~1.9k tokensUpdated 17 days ago
    Marketing & SEOAuto-check passed
  • SEO Content Brief

    seranking/seo-skills

    Generate a writer-ready SEO content brief from a target domain and topic.

    161 GitHub stars~2.5k tokensUpdated 3 mo ago
    Marketing & SEOAuto-check passed
  • Blog Outline

    AgriciDaniel/claude-blog

    SERP-informed outline generation with H2/H3 heading hierarchy, competitive content gap analysis, section-by-section word count targets, chart and image placement markers, optional FAQ question…

    2.3k GitHub starsUsed in 1 repo~1.5k tokens
    Marketing & SEOAuto-check passed
  • SEO Keyword Cluster

    seranking/seo-skills

    Build a content cluster plan from seed keywords — intent-grouped clusters, pillar+spokes architecture with H1/H2 suggestions per spoke, prioritised build order, and an internal-linking map.

    161 GitHub stars~2.5k tokensUpdated 3 mo ago
    Marketing & SEOAuto-check passed

More from OpenClaudia/openclaudia-skills

All 74 skills in this repo
  • Competitor Traffic Report

    OpenClaudia/openclaudia-skills

    Build an interactive competitive-traffic report for any company and its rivals — monthly visits (SimilarWeb), organic search traffic and Domain Rating (Ahrefs) — as one self-contained HTML page with…

    713 GitHub stars~1.2k tokensUpdated 22 days ago
    Auto-check passed
  • Geo Difficulty

    OpenClaudia/openclaudia-skills

    Score how hard a keyword is to rank for in the AI-search era — page-level URL Rating of real competitors (not just domain DR), Ahrefs keyword difficulty, and whether a given site already ranks or is…

    713 GitHub stars~694 tokensUpdated 22 days ago
    Auto-check passed
  • Gsc Portfolio Audit

    OpenClaudia/openclaudia-skills

    Audit EVERY Google Search Console property at once — rank all sites by clicks and impressions with period-over-period deltas, then diff keywords per site to surface what is newly ranking, rising…

    713 GitHub stars~1k tokensUpdated 22 days ago
    Auto-check passed
  • Similarweb Traffic

    OpenClaudia/openclaudia-skills

    Fetch website traffic estimates (monthly visits, traffic sources, top countries, keywords, engagement, ranks) for any domain from SimilarWeb.

    713 GitHub stars~882 tokensUpdated 22 days ago
    Auto-check passed
  • Ahrefs Python

    OpenClaudia/openclaudia-skills

    Manages Ahrefs API usage in Python using ahrefs-python library.

    713 GitHub stars~1.9k tokensUpdated 22 days ago
    Auto-check passed
  • Ab Test Setup

    OpenClaudia/openclaudia-skills

    Design, plan, and analyze A/B tests with statistical rigor. An agent skill from OpenClaudia/openclaudia-skills.

    713 GitHub stars~1.7k tokensUpdated 22 days ago
    Auto-check passed

Categories

Questions about SEO Content Brief

What does SEO Content Brief do?

Create an SEO content brief for writers. An agent skill from OpenClaudia/openclaudia-skills. SEO Content Brief is an agent skill from OpenClaudia/openclaudia-skills. Create an SEO content brief for writers.

When should I use SEO Content Brief?

SEO Content Brief fits situations like: the user says content brief; outline for SEO; asks about creating a structured brief to hand to a writer for producing search-optimized content.

How do I install SEO Content Brief in Claude Code?

Run `npx skills add OpenClaudia/openclaudia-skills --skill seo-content-brief -a claude-code`. Or copy the skill folder (skills/seo-content-brief in OpenClaudia/openclaudia-skills) into .claude/skills/seo-content-brief in your project. Claude Code loads it when a task matches its description.

How do I install SEO Content Brief in Codex?

Run `npx skills add OpenClaudia/openclaudia-skills --skill seo-content-brief -a codex`. Or copy the skill folder (skills/seo-content-brief in OpenClaudia/openclaudia-skills) into .agents/skills/seo-content-brief in your project. Codex loads it when a task matches its description.

Can I use SEO Content Brief in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add OpenClaudia/openclaudia-skills --skill seo-content-brief -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/seo-content-brief, .gemini/skills/seo-content-brief, .github/skills/seo-content-brief and .opencode/skills/seo-content-brief in your project.

What does SEO Content Brief need to run?

Going by SKILL.md and its folder, SEO Content Brief needs the command-line tools its instructions call (curl) and credentials named SEMRUSH_API_KEY. Our summary lists: A credential in SEMRUSH_API_KEY.

Does SEO Content Brief access the network?

SKILL.md names 1 domain. In commands or code: api.semrush.com; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is SEO Content Brief safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does SEO Content Brief use?

SEO Content Brief is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does SEO Content Brief use?

About 1.8k tokens (SKILL.md is roughly 7.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to SEO Content Brief?

Skills that share tags, products or a category with SEO Content Brief: SEO Keyword Clustering (AgriciDaniel/claude-seo, 19k stars), SEO Content Brief Generator (AgriciDaniel/claude-seo, 19k stars), E2E SEO Assistant (irinabuht12-oss/marketing-skills, 4.1k stars) and SEO Content Brief (seranking/seo-skills, 161 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains SEO Content Brief?

OpenClaudia (a GitHub organization) maintains it in OpenClaudia/openclaudia-skills, which has 713 GitHub stars. The repository holds 74 skills in this directory. The repository was last updated on September 18, 2026.

Source: OpenClaudia/openclaudia-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.