New: 98,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

SEO Content Brief Generator

by AgriciDaniel in 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.

MITAuto-check passedMarketing & SEO

Install SEO Content Brief Generator

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

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

GitHub CLI
$ gh skill install AgriciDaniel/claude-seo 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/AgriciDaniel/claude-seo.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
19k
Used in
2 other repos
Token cost
~2.6k tokens
SKILL.md length
1,178 words
Files
5 (incl. references)
Skills in repo
33
Repo updated
First seen
Licence
MIT

At a glance

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

  • Works in 5 steps: Determine Brief Mode → Fetch Context → Analyse SERPs → …
  • Preparing a brief for a writer before drafting a blog post or service page
  • SKILL.md covers Process, Critical Rules, Keyword Density and Placement and Meta Tag Rules, plus 8 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

The skill generates briefs that help writers produce pages able to outrank the current top results. It first picks a mode: improve mode when an existing page URL is given, where it keeps what is strong and adds only missing, thin or outdated sections, or new page mode when only a keyword or topic is given. It fetches the target page, homepage and sitemap for business context, which feeds a Website Relevance Rule.

SERP analysis identifies the top five ranking pages, filters out non-competitors such as Wikipedia, Reddit, marketplaces and directories, scores each real competitor from 1 to 10 for depth, formatting, SEO and UX, and finds topic, depth and quality gaps ranked by impact, advantage and effort. Search intent is classified as informational, commercial, transactional or navigational, and the brief applies a page-type template with keyword placement and density guidance, drawing on reference files for excluded domains, keyword density and templates.

When your agent uses it

  • Preparing a brief for a writer before drafting a blog post or service page
  • Planning improvements to an existing page that is not ranking
  • Finding topic and depth gaps against the top-ranking competitors

Example prompts

  • “Write a content brief for a service page targeting 'emergency plumber in Leeds'.”
  • “Create an improve-mode brief for https://example.com/blog/ai-seo.”
  • “Give me a blog brief with per-section word counts for 'how to choose a CRM'.”

Requirements

  • Network access to fetch the target site and search results

Workflow steps

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

  1. Determine Brief Mode
  2. Fetch Context
  3. Analyse SERPs
  4. Classify Search Intent
  5. Build the Brief

What it can do on your machine

Read from SKILL.md and the folder at commit 4b99de2. 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

    No scripts in the folder and no shell commands in SKILL.md.

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

  • Network

    No URLs in SKILL.md.

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

  • Credentials

    Names no API keys, tokens, secrets or passwords.

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

Context cost

SEO Content Brief Generator loads about 2.6k tokens when it runs, and up to ~5.9k if it reads all its reference files. Until then it costs about 99 tokens; SKILL.md has 1,178 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~99
When it runs · the whole SKILL.md, loaded when a task matches
~2.6k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~5.9k

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 AgriciDaniel/claude-seo at commit 4b99de2, republished under its MIT licence (© AgriciDaniel). 1,178 words, ~2,634 tokens.

Download SKILL.mdSave it as .claude/skills/seo-content-brief/SKILL.md (or your agent's skills folder). This skill also uses 4 other files; get the full folder from GitHub.
name
seo-content-brief
description
Generate competitive SEO content briefs with per-section word counts, competitor scoring, keyword density guidance, and page-type templates. Supports both new page briefs and improve-existing-page briefs. Use when user says "content brief", "write a brief", "content outline", "blog brief", "service page brief", "brief for", "writing brief", "content plan", or "outline for".
user-invocable
true
argument-hint
[url-or-keyword] [page-type]
license
MIT
metadata.author
puneetindersingh
metadata.original_author
puneetindersingh
metadata.version
1.0.0
metadata.category
seo

SEO Content Brief Generator

Generate research-backed content briefs that help writers produce pages capable of outranking current top results. Briefs include competitor analysis with gap scoring, per-section word count breakdowns, keyword placement rules, and page-type-specific templates.

Process

1. Determine Brief Mode

Improve mode (existing page URL provided):

  • Fetch the existing page content and structure
  • Identify what is already strong (keep it)
  • Identify missing, thin, or outdated sections
  • Distinguish "keep/strengthen" vs "add new" sections in the outline
  • Do not recommend a full rewrite when targeted improvements will win

New page mode (keyword or topic provided, no existing page):

  • Use the target site's homepage or sitemap for business context only
  • Build the brief from scratch for a new page
  • Focus on competitive gaps the new page can fill
2. Fetch Context
  • Fetch the target URL or homepage to understand the business
  • Fetch the sitemap to discover all existing pages, categories, and services
  • This context is critical for the Website Relevance Rule (see below)
3. Analyse SERPs
  • Identify the top 5 ranking pages for the target keyword
  • Filter out non-competitors (Wikipedia, Reddit, Pinterest, Amazon, YouTube, government sites, SEO tool pages, job boards, directories, news aggregators, social platforms). See references/excluded-domains.md for the full list.
  • Score each real competitor: Depth (1-10), Formatting (1-10), SEO (1-10), UX (1-10)
  • Identify three gap types:
    • Topic gaps: subtopics competitors miss entirely
    • Depth gaps: topics covered but shallow
    • Quality gaps: outdated info, no expert perspective, poor formatting
  • Calculate gap priority: Impact x Competitive Advantage / Effort
4. Classify Search Intent
  • Informational: user wants to learn (guides, how-tos, definitions)
  • Commercial: user is researching before buying (comparisons, reviews, "best X")
  • Transactional: user is ready to act (buy, book, enquire, sign up)
  • Navigational: user is looking for a specific site or page

Identify what SERP format Google rewards for this query: long-form guide, listicle, comparison table, landing page, FAQ, video, local pack.

5. Build the Brief

Apply the page-type template from references/page-type-templates.md, then customise based on competitor gaps and search intent.

Critical Rules

Website Relevance Rule

Every heading, subtopic, keyword, and FAQ you suggest must be something the target website can credibly write about based on its actual services or products.

  • Read the site's homepage and sitemap to understand what it does
  • Do not borrow competitor structure if those sections cover things this site does not offer
  • Before each suggestion, ask: "Can this website actually deliver on this content?" If no, remove it.
Site Structure Coverage Rule

When briefing a hub, overview, category, or "types of" page:

  • The outline must reference every relevant product category, service, or sub-page that exists on the site
  • Do not invent categories that don't exist, do not leave out categories that do exist
  • Each category should appear as its own section with an internal link suggestion
  • This ensures the page acts as a proper hub linking to all child pages

For non-hub pages (single service page, blog post), use site structure to suggest relevant internal links but do not force every category into the outline.

Output Language Rules
  • Never mention researcher names, framework names, or tool names in the output (no "Ben Goodey method", "Frase.io formula", "Princeton GEO", "Clearscope", "Backlinko")
  • These are internal thinking tools only. The output must read as plain, professional advice.
  • Write for a business owner or content writer, not an SEO academic

Keyword Density and Placement

Read references/keyword-density.md for the full rules. Summary:

Primary keyword use: Use the primary keyword naturally in high-value locations.

  • Do not optimize to a fixed density. Treat density checks as optional internal readability/stuffing heuristics only.
  • First 1-2 mentions help establish topic context. Diminishing returns after.
  • For a 1,000-word article, avoid forced repetition across headings, body, and alt text.

Primary keyword must appear in:

  1. Title tag (near the front)
  2. H1 tag (near the front)
  3. URL slug
  4. Meta description
  5. First paragraph / first 100 words
  6. At least one image alt text

Primary keyword does NOT need to appear in:

  • Every H2 or H3 (subtopics carry context naturally if H1 covers it)
  • Every paragraph or section

Secondary keywords:

  • 5-8 closely related supporting terms distributed through body content
  • 10-15 broader semantic terms covering related concepts
  • Use in H2-H6 subheadings where natural
  • Synonyms improve readability and do NOT count toward keyword density

Per-section keyword guidance: For each section in the outline, specify:

  • Which keyword (primary or secondary) belongs in the heading
  • Whether the body should include the primary keyword or a variation
  • Example: "Use secondary keyword 'structural drafting services' in H2. Body: mention primary keyword once."

Distribution: Spread the primary keyword evenly. Do not front-load or cluster in one section.

Show full SKILL.md (418 more words)Show less

Meta Tag Rules

Title tag:

  • 50-60 characters (never under 50, never over 60)
  • Primary keyword first, brand name last
  • Separate brand with a pipe or dash (match the site's existing pattern)
  • Lead with outcomes, numbers, or specifics when possible

Meta description:

  • 130-150 characters (never under 130, never over 150)
  • Active voice, expand on the title with USPs and specifics
  • End with a call to action
  • No brand name at the end (it's already in the title)
  • No quotes (Google truncates at quotes)

Information Gain (non-negotiable)

Every brief must specify EXACTLY what new value this content adds that no current ranking page provides. Must be specific:

  • Proprietary data or original research
  • Case studies with real outcomes
  • Expert quotes or first-hand experience
  • Original synthesis or unique framework
  • NOT "more detail" or "better formatting"

E-E-A-T Requirements

List the exact trust signals this content needs:

  • Author credentials and bio relevant to the topic
  • Expert quotes or citations from authoritative sources
  • Cited studies, data, or statistics with dates
  • Last updated date
  • Especially critical for YMYL topics (health, finance, legal, safety)

Internal Linking

  • Suggest 3-5 specific internal link opportunities with anchor text
  • Specify whether the page is a hub (links out to cluster pages) or spoke (links to pillar page)
  • Use the site structure from the sitemap to find real link targets

Output Format

Always output in this exact structure:

## Content Brief: [Primary Keyword]

### Search Intent
[Intent type, SERP format rewarded, target audience and knowledge level. 3-4 lines.]

### Competitor Analysis
| # | URL | Key H2 Sections | Est. Words | Score | Main Gap |
|---|-----|-----------------|------------|-------|----------|
| 1 | ... | ...             | ...        | X/40  | ...      |

### Content Gaps and Opportunities
[Bullet list: topic gaps, depth gaps, quality gaps with specifics]

### Winning Outline

**H1:** [H1 with primary keyword]
**URL Slug:** /[slug]
**Target Word Count:** ~[X] words (competitor avg: ~[X] words)

[Full H2/H3 outline with:
- Word count per section
- Content format notes (bullet list, table, definition box, etc.)
- Featured Snippet targets marked with "FS target"
- Per-section keyword guidance]

### Recommended Meta Tags

**Title**
[title, 60 chars max]

**Meta Description**
[description, 150 chars max]

### Unique Angle and Information Gain
[Specific paragraph: what exact new value this piece adds]

### E-E-A-T Requirements
[Bullet list of exact trust signals needed]

### Internal Linking Opportunities
[3-5 suggestions with anchor text and target URL]

Outline-Only Mode

When the user asks for "just an outline" or "content outline" instead of a full brief, skip the Competitor Analysis table, Content Gaps section, Information Gain section, and E-E-A-T section. Output only:

## Content Outline: [Primary Keyword]

**H1:** [H1 with primary keyword]
**URL Slug:** /[slug]
**Target Word Count:** ~[X] words (competitor avg: ~[X] words)

[Full H2/H3 outline with word counts, format notes, FS targets, keyword guidance, and a 1-2 sentence writing note per section]

DataForSEO Integration (Optional)

If DataForSEO MCP tools are available, use serp_organic_live_advanced for real SERP data and competitor analysis, kw_data_google_ads_search_volume for keyword volume, dataforseo_labs_bulk_keyword_difficulty for difficulty scores, dataforseo_labs_search_intent for intent classification, and on_page_content_parsing for competitor content extraction.

Ahrefs Integration (Optional)

If Ahrefs MCP tools are available, use keywords-explorer-overview for keyword volume and difficulty, serp-overview for SERP analysis, site-explorer-organic-keywords for existing keyword rankings, and site-explorer-top-pages for competitor page performance.

Error Handling

ScenarioAction
Target URL unreachableReport the error. Do not guess page content. Ask the user to verify the URL.
No competitors found after filteringBroaden the search to include partial-match competitors. Note the thin competitive landscape in the brief.
Sitemap not foundProceed without site structure context. Note that internal linking suggestions may be incomplete.
Page type not specifiedAuto-detect from the keyword intent and SERP format. State the detected type in the brief.
Target word count not specifiedUse competitor average as the baseline. Note this in the outline.

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

Files

SKILL.md and 4 other files (references) in skills/seo-content-brief of AgriciDaniel/claude-seo.

  • SKILL.md
  • LICENSE.txt
  • references/excluded-domains.md
  • references/keyword-density.md
  • references/page-type-templates.md

Open the folder on GitHubat commit 4b99de2

Used in 3 other repositories

We found 4 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 2 other GitHub owners. This page covers the copy in AgriciDaniel/claude-seo, which our catalogue first saw on October 7, 2026.

Compare with similar skills

SEO Content Brief Generator 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 Generator compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
SEO Content Brief Generator this skillAgriciDaniel/claude-seo19k2 repos~2.6kAutomated safety check: PassMIT
Blog OutlineAgriciDaniel/claude-blog2.3k1 repos~1.5kAutomated safety check: PassMIT
SEO Keyword Clusterseranking/seo-skills161—~2.5kAutomated safety check: PassMIT
Content Brief Authoringrampstackco/claude-skills945—~5.6kAutomated safety check: PassMIT
Ink Clusterjeremylongshore/tons-of-skills-marketplace2.8k—~1.3kAutomated safety check: NotesMIT
SEO Keyword Cluster Buildersecondsky/claude-skills227—~3.1kAutomated safety check: PassMIT

Similar skills

  • 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

  • Content Brief Authoring

    rampstackco/claude-skills

    How to author a content brief that actually guides a writer (human or AI) to produce a piece that ranks, converts, or both.

    945 GitHub stars~5.6k tokensUpdated 3 days ago
    Marketing & SEOAuto-check passed

  • Ink Cluster

    jeremylongshore/tons-of-skills-marketplace

    Topic cluster architecture builder — takes a core topic and maps the full cluster with 1 pillar page, 6-10 supporting posts, internal linking map, keyword targets, and estimated monthly search…

    2.8k GitHub stars~1.3k tokensUpdated today
    Marketing & SEOAuto-check: notes

  • SEO Keyword Cluster Builder

    secondsky/claude-skills

    SEO keyword clustering with topic organization, content hub architecture, internal linking strategies.

    227 GitHub stars~3.1k tokensUpdated 12 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

More from AgriciDaniel/claude-seo

All 33 skills in this repo

  • Hreflang and International SEO

    AgriciDaniel/claude-seo

    Audits, validates and generates hreflang tags for multi-language and multi-region sites in HTML, HTTP headers or XML sitemaps, flagging common code and return-tag mistakes.

    19k GitHub starsUsed in 5 repos~3.4k tokens
    Auto-check passed

  • Google SEO APIs

    AgriciDaniel/claude-seo

    Pulls real Google data for SEO work: Search Console, PageSpeed Insights, CrUX field data, the Indexing API and GA4 organic traffic, through /seo google commands.

    19k GitHub starsUsed in 1 repo~4.2k tokens
    Auto-check passed

  • 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
    Auto-check passed

  • FLOW SEO Framework

    AgriciDaniel/claude-seo

    Brings the FLOW framework's stage-specific SEO prompts into the agent, from keyword discovery through backlinks, on-page work and conversion to local SEO, loaded on demand.

    19k GitHub starsUsed in 2 repos~1.4k tokens
    Auto-check passed

  • SEO Image Generator

    AgriciDaniel/claude-seo

    Generates Open Graph previews, blog hero images, product photos and infographics for SEO use through Gemini image tools and the banana extension.

    19k GitHub starsUsed in 2 repos~2.1k tokens
    Auto-check passed

  • SEO Drift Monitor

    AgriciDaniel/claude-seo

    Captures baselines of a page's SEO-critical elements, compares later snapshots against them and flags regressions by severity, like version control for on-page SEO.

    19k GitHub starsUsed in 1 repo~1.9k tokens
    Auto-check passed

Categories

Questions about SEO Content Brief Generator

What does SEO Content Brief Generator do?

Builds research-backed SEO content briefs with competitor scoring, per-section word counts and page-type templates, for new pages or improving existing ones. The skill generates briefs that help writers produce pages able to outrank the current top results. It first picks a mode: improve mode when an existing page URL is given, where it keeps what is strong and adds only missing, thin or outdated sections, or new page mode when only a keyword or topic is given.

When should I use SEO Content Brief Generator?

SEO Content Brief Generator fits situations like: preparing a brief for a writer before drafting a blog post or service page; planning improvements to an existing page that is not ranking; finding topic and depth gaps against the top-ranking competitors.

How do I install SEO Content Brief Generator in Claude Code?

Run `npx skills add AgriciDaniel/claude-seo --skill seo-content-brief -a claude-code`. Or copy the skill folder (skills/seo-content-brief in AgriciDaniel/claude-seo) 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 Generator in Codex?

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

Can I use SEO Content Brief Generator 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 AgriciDaniel/claude-seo --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 Generator need to run?

SKILL.md names no scripts, command-line tools or credentials: SEO Content Brief Generator is instructions for the agent only. Our summary lists: Network access to fetch the target site and search results.

Does SEO Content Brief Generator access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is SEO Content Brief Generator 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 Generator use?

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

How many tokens does SEO Content Brief Generator use?

About 2.6k tokens (SKILL.md is roughly 11k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 3.3k tokens, read only when the agent opens those files.

What are the alternatives to SEO Content Brief Generator?

Skills that share tags, products or a category with SEO Content Brief Generator: Blog Outline (AgriciDaniel/claude-blog, 2.3k stars), SEO Keyword Cluster (seranking/seo-skills, 161 stars), Content Brief Authoring (rampstackco/claude-skills, 945 stars) and Ink Cluster (jeremylongshore/tons-of-skills-marketplace, 2.8k 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 Generator?

AgriciDaniel (a GitHub user) maintains it in AgriciDaniel/claude-seo, which has 18,627 GitHub stars. The repository holds 33 skills in this directory. The repository was last updated on October 4, 2026.

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