Seo Content Brief
Produce a research-backed SEO brief with section word counts and competitor gaps before a writer or agent drafts a new or improved page.
Overview
SEO Content Brief is an agent skill most often used in Launch (also Grow content planning) that generates competitor-backed SEO briefs with per-section word counts, gap scoring, and page-type templates for new or existin
Install
npx skills add https://github.com/agricidaniel/claude-seo --skill seo-content-briefWhat is this skill?
- Two modes: new-page briefs from a keyword/topic and improve-existing-page briefs from a live URL
- Competitor analysis with gap scoring plus per-section word count breakdowns
- Keyword density and placement rules aligned to page-type templates
- Preserve-and-strengthen guidance so existing strong sections are not rewritten unnecessarily
- Argument hint supports `[url-or-keyword] [page-type]` for fast invocation
- Supports both new-page and improve-existing-page brief modes
- Includes per-section word count breakdowns and competitor gap scoring
- Ships page-type-specific SEO templates in the brief workflow
Adoption & trust: 676 installs on skills.sh; 8.5k GitHub stars; 2/3 security scanners passed (skills.sh audits).
What problem does it solve?
You know the keyword or page you want to rank for but lack a section-level outline, word-count targets, and a clear picture of what top competitors already cover.
Who is it for?
Solo builders shipping landing pages, service pages, or blog posts who want SERP-informed outlines before writing or delegating to an agent.
Skip if: Teams that only need a one-line topic idea without competitor research, technical SEO audits, or link-building strategy.
When should I use this skill?
User says "content brief", "write a brief", "content outline", "blog brief", "service page brief", "brief for", "writing brief", "content plan", or "outline for".
What do I get? / Deliverables
You get a structured brief with competitor gaps, keyword placement guidance, and section word counts so the next draft or agent run targets rankable depth instead of generic copy.
- SEO content brief with section outline and word-count targets
- Competitor gap notes and keyword placement rules
- Keep/strengthen vs add-new section guidance for improve mode
Recommended Skills
Journey fit
Spans multiple journey phases - primary shelf plus alternate fits below.
Content briefs are the standard pre-writing artifact for pages meant to rank, which maps to Launch → SEO in the solo-builder journey. The skill targets keyword placement, competitor gap scoring, and page-type SEO templates—not distribution or analytics dashboards.
Where it fits
Draft a brief for a validation landing page keyword before the first publishable hero and FAQ sections exist.
Generate a service-page brief with section word counts after reviewing top-ranking competitors for the money keyword.
Run improve mode on a stale blog URL to add missing sections competitors already cover.
Compare content depth expectations across niches before choosing which topic cluster to build first.
How it compares
Use instead of asking an agent for a flat blog outline without word-count targets or scored competitor gap analysis.
Common Questions / FAQ
Who is seo-content-brief for?
Indie founders, marketers, and builder-writers who publish web pages and want agent-assisted briefs that mirror what already ranks before drafting content.
When should I use seo-content-brief?
Use it in Launch when planning SEO pages (blog brief, service page brief, content outline), and in Grow when refreshing thin or outdated pages—say "content brief", "brief for [keyword]", or pass an existing URL for improve mode.
Is seo-content-brief safe to install?
It is a procedural writing/research skill (MIT-licensed metadata); review the Security Audits panel on this Prism page and inspect SKILL.md in the repo before enabling it in production agent workflows.
SKILL.md
READMESKILL.md - Seo Content Brief
# 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 po