What is a Claude SEO brief writer skill?

Quick Answer: A Claude SEO brief writer skill is a custom instruction set that turns Claude into a dedicated content strategist. You give it a target keyword, and it researches search intent, analyses what top-ranking pages cover, and outputs a structured brief ready for a writer. This tutorial shows you how to build one from scratch.

If you're running content at any scale inside a B2B SaaS company, you already know the brief is where most time gets wasted. A writer waits on a strategist. A strategist waits on a researcher. The brief comes back thin, the article misses intent, and you repeat the cycle.

This tutorial walks you through building a Claude skill that collapses SERP research and brief generation into a single workflow. By the end, you'll have a reusable skill file you can drop into Claude Code and run against any keyword in under two minutes.

What Is a Claude Skill, and Why Build One for SEO Briefs?

A Claude skill is a structured instruction file (typically a SKILL.md or system prompt) that gives Claude a persistent role, a defined process, and a consistent output format. Instead of re-explaining what you want every time, the skill does that work for you automatically.

For SEO brief writing specifically, a skill solves three problems that generic prompts don't:

• Consistency: Every brief follows the same structure, so writers know exactly what to expect
• Depth: The skill enforces research steps rather than letting Claude skip straight to output
• Speed: One keyword in, one complete brief out, with no back-and-forth

This is the difference between using Claude as a chat tool and using it as a repeatable content operation.

What Should a Claude SEO Brief Writer Skill Actually Do?

A well-built SEO brief writer skill handles two distinct jobs in sequence: research, then brief generation.

Research phase:

• Identify the primary search intent behind the keyword (informational, navigational, commercial, transactional)
• Infer what content types are ranking (listicles, how-to guides, comparison pages, landing pages)
• Extract the sub-topics, questions, and angles that top-ranking pages address
• Identify content gaps that the brief should fill

Brief generation phase:

• Produce a recommended H1 and meta description
• Outline H2 and H3 structure with notes on what each section should cover
• Specify word count range based on intent and competition signals
• List primary keyword, secondary keywords, and semantic terms to include
• Flag internal linking opportunities if context is provided
• Include a suggested FAQ section based on People Also Ask patterns

The output should be something a writer can act on immediately, with no interpretation required.

How to Build the Skill: Step-by-Step

Step 1: Create Your Skill File

In Claude Code, create a new file called SKILL.md inside a /skills/seo-brief-writer/ directory. This is where the entire skill lives.

The file has three sections: role definition, process instructions, and output format.

# SEO Brief Writer Skill

## Role
You are a B2B SaaS content strategist specialising in SEO and GEO (generative engine optimisation).
Your job is to take a target keyword and produce a complete, writer-ready content brief.
You do not write the article. You produce the brief.

## Process
When given a keyword, follow these steps in order:

1. INTENT ANALYSIS
   - Classify the search intent: informational, navigational, commercial, or transactional
   - Identify the dominant content format for this keyword (listicle, how-to, comparison, etc.)
   - State what the searcher is trying to accomplish

2. SERP INFERENCE
   - Based on the keyword, infer what sub-topics, questions, and angles top-ranking pages likely cover
   - Identify 3-5 content gaps or differentiation opportunities
   - Note any secondary intents the content should address

3. BRIEF GENERATION
   - Output a structured brief using the format below

## Output Format
[see Step 2 below]

Step 2: Define the Output Format

This is the section writers will actually use. Be specific. Vague instructions produce vague output.

## Output Format

### Target Keyword
[Primary keyword exactly as provided]

### Search Intent
[One sentence describing what the searcher wants]

### Recommended Content Type
[Format: how-to guide / listicle / comparison / etc.]

### Suggested H1
[One option, keyword-rich, human-friendly]

### Meta Description
[150-160 characters, includes primary keyword, has a clear value proposition]

### Estimated Word Count
[Range based on intent: e.g. 1,200-1,800 words]

### Content Outline
H2: [Section title]
- What to cover: [2-3 bullet points]
- Keywords to include: [list]

H2: [Section title]
- What to cover: [2-3 bullet points]
- Keywords to include: [list]

[Continue for all major sections]

### Primary Keyword
[Keyword]

### Secondary Keywords
[3-5 related terms]

### Semantic Terms to Include
[5-8 co-occurring concepts that signal topical depth]

### FAQ Section (Suggested Questions)
1. [Question]
2. [Question]
3. [Question]

### Content Gaps to Address
[2-3 specific angles or data points the brief should hit that competitors likely miss]

### Internal Linking Opportunities
[Only populate if site context has been provided]

Step 3: Add a B2B SaaS Context Layer

Generic SEO briefs miss the nuances of B2B content. Add a context block to your skill that tells Claude what kind of audience it's writing for.

If you want the output to align with a SaaS-specific editorial standard, it also helps to review how specialist providers structure strategy and execution in B2B SaaS SEO agencies.

## Audience Context
Unless told otherwise, assume:
- Reader is a B2B SaaS founder, head of marketing, or content lead
- They are evaluating tools, processes, or strategies to grow organic traffic
- Content should reflect commercial awareness (this is not a consumer blog)
- Avoid beginner-level explanations of basic SEO concepts unless the keyword demands it
- Include specific examples, numbers, and outcomes wherever possible

This single addition shifts the brief quality significantly. Claude stops writing for a generic audience and starts writing for your ICP.

Step 4: Add GEO Instructions

AI search citation is now a real traffic channel for B2B SaaS, so your brief should instruct writers to produce content that gets cited by tools like Perplexity, ChatGPT, and Google AI Overviews.

If you're building around AI-era discoverability rather than traditional rankings alone, this is also where a shortlist of B2B SaaS GEO/AEO agencies can be useful for benchmarking how teams are adapting content for citation.

Add this block to your skill file:

## GEO Requirements
Every brief should include instructions for the writer to:
- Open each major section with a standalone, definitional sentence that answers the implied question directly
- Write at least one 40-60 word block per section that works as a self-contained snippet
- Use precise language over vague language (specific numbers, named tools, named outcomes)
- Include a Quick Answer box at the top of the article
- Structure FAQ answers so they can be extracted and cited without surrounding context

Step 5: Test the Skill with a Real Keyword

With the skill file in place, run it in Claude Code with a simple prompt:

Run the SEO brief writer skill for this keyword: "claude seo brief writer skill"

Claude will work through the intent analysis, SERP inference, and brief generation steps in sequence. Review the output against these criteria:

• Does the H1 include the primary keyword naturally?
• Are the H2s answering distinct sub-questions, not just rephrasing the same point?
• Is the word count range realistic for the intent?
• Do the FAQ questions match how someone would actually ask an AI tool?

Adjust the skill file based on what's missing. Most teams iterate 2-3 times before the output is consistently usable.

How to Use the Skill Inside a Content Workflow

The skill works best as the first step in a content pipeline, not a standalone tool.

Recommended workflow:

1. Keyword list enters the pipeline (from Ahrefs, Search Console, or manual research)
2. Run the SEO brief writer skill for each target keyword
3. Brief goes to a writer for drafting
4. Draft returns for editing against the brief
5. Final article is published with the brief as the QA checklist

The brief file also becomes your post-publish audit tool. When you review performance after 90 days, you can check whether the published article actually covered what the brief specified.

Common Mistakes When Building This Skill

Skipping the output format definition. If you don't specify exactly what you want Claude to produce, it defaults to a format that suits it, not your workflow. Define every field.

No audience context. A brief written for a general reader and a brief written for a B2B SaaS buyer look completely different. Add the context block from Step 3.

Treating the skill as finished after one test. The first version will have gaps. Run it against five different keywords across different intents and formats before you commit to using it in production.

Expecting Claude to replace live SERP data. This skill infers from Claude's training data. For keywords where real-time ranking data matters, combine the skill with a live SERP scrape or a tool like Keyword Insights to feed actual competitor URLs into the context window.

If the workflow expands beyond briefs into channel planning, distribution, and paid acquisition, some teams also compare where SEO fits alongside B2B SaaS digital marketing agencies or more specialised B2B SaaS content marketing agencies.

FAQs

What is a Claude SEO brief writer skill? A Claude SEO brief writer skill is a structured instruction file that gives Claude a defined role, a research process, and a fixed output format for generating content briefs. You provide a keyword, and the skill produces a complete brief including H1, meta description, content outline, keyword targets, and FAQ suggestions, without any manual prompting.

How is a Claude skill different from a regular prompt? A prompt is a one-off instruction. A skill is a persistent, reusable system that runs the same process every time. Skills live in a file (typically SKILL.md) and can be called on demand inside Claude Code, meaning the role, process, and output format are always consistent without re-entering them.

Can this skill replace a dedicated SEO tool like Ahrefs or Semrush? No, and it shouldn't try to. This skill handles brief structure, intent classification, and content planning. It does not provide live search volume data, backlink analysis, or real-time ranking information. The best setup combines this skill with a keyword research tool for data and Claude for brief generation.

Is this skill suitable for B2B SaaS content specifically? Yes, with the audience context block from Step 3 in place. Without that block, the skill produces generic briefs. With it, Claude adjusts tone, depth, and framing for a B2B buyer audience automatically.

How long does it take to build this skill? The initial skill file takes 30-45 minutes to write and configure. Testing and iteration across five or six keywords adds another hour. Most teams have a production-ready version within a half-day of focused work.