# SEO Content Brief

Generate competitive SEO content briefs with per-section word counts, competitor...

- Repository: https://github.com/AgriciDaniel/claude-seo (25484 stars)
- Category: Marketing
- License: MIT
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add AgriciDaniel/claude-seo --skill seo-content-brief -g -a claude-code -y`
Codex: `npx skills add AgriciDaniel/claude-seo --skill seo-content-brief -g -a codex -y`
Cursor: `npx skills add AgriciDaniel/claude-seo --skill seo-content-brief -g -a cursor -y`
Gemini CLI: `npx skills add AgriciDaniel/claude-seo --skill seo-content-brief -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add AgriciDaniel/claude-seo`

## Description

Generate competitive SEO content briefs with per-section word counts, competitor scoring, keyword placement 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".

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# 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

The rest: https://github.com/AgriciDaniel/claude-seo/blob/HEAD/skills/seo-content-brief/SKILL.md