Complete Guide: How To Build A Claude Skill For SEO Content Writing

To build a Claude Skill for SEO content writing, you give Claude three documents (a tone of voice file, a mini sitemap CSV and an experience document) plus a master prompt, and package them as a Skill that Claude runs every time you write an article. The result is SEO content that sounds like you, links to your real pages and uses your own proof, without re-pasting instructions in every chat.

This guide walks through each document, the skill setup in Claude, how to run it, and what to check before you publish. If Skills are new to you, start with what Claude Skills are.

What Is A Claude Skill?

A Claude Skill is a reusable workflow system inside Claude.

Instead of:

→ writing massive prompts every time

→ repeating your writing style

→ manually adding SEO instructions

→ fixing internal links yourself

You package everything once.

Then Claude remembers your workflow every time you activate the skill.

Think of it like this:

Normal prompting:

You train a freelancer every single day.

Claude Skills:

You train an employee once.

Why Claude Skills Matter For SEO

Most people use AI like this:

→ open Claude

→ type random prompt

→ get generic article

→ spend 1 hour rewriting everything

The biggest problem:

AI forgets everything in every new chat.

Your:

✓ tone

✓ structure

✓ website pages

✓ writing preferences

✓ SEO rules

✓ internal links

All disappear.

Claude Skills solve this problem.

Difference Between Skills, Projects, And Custom Instructions

1. Custom Instructions

Global settings across all chats.

Example:

→ “Always answer concisely”

→ “Act like a software engineer”

Always active.

2. Projects

A workspace with:

→ documents

→ instructions

→ files

Useful for specific projects.

3. Claude Skills

Skills are activated only when needed.

Most important difference:

Skills can include external files.

Example:

✓ style guides

✓ CSV files

✓ screenshots

✓ case studies

✓ writing samples

✓ sitemap data

This makes outputs far more personalized.

What You Need Before Building The Skill

You need 3 core documents.

These documents are the real engine behind the SEO skill.

Document 1. Tone Of Voice File

This teaches Claude:

→ how you write

→ how you structure sentences

→ phrases you use

→ phrases you hate

→ your communication style

Without this:

AI sounds generic.

With this:

Claude sounds like you.

What To Include

Writing Style

→ conversational

→ direct

→ technical

→ educational

→ storytelling

Sentence Structure

→ short sentences

→ long explanations

→ humor level

→ formatting style

Words You Avoid

Very important.

Example:

Avoid:

✗ “game changer”

✗ “revolutionary”

✗ “unlock”

✗ “delve into”

This removes obvious AI writing patterns.

Best Way To Create It

Do NOT write this manually.

Instead:

1. Gather: → old blog posts → YouTube scripts → newsletters → emails
2. Upload them into Claude.
3. Ask: “Analyze my writing style and create a detailed tone of voice document.”

Claude generates the file automatically.

Document 2. Mini Sitemap CSV

This helps Claude create internal links correctly.

Without this:

AI invents random links.

With this:

Claude links to real pages on your site.

What To Include

You only need:

✓ important pages

✓ blogs

✓ products

✓ landing pages

✓ course pages

CSV Structure Example

Important Rule

Quality over quantity.

Do NOT upload your full sitemap.

Only upload pages you WANT Claude to link to.

Document 3. Experience Document

This is what makes content credible.

Add:

✓ case studies

✓ screenshots

✓ metrics

✓ stories

✓ results

✓ experiments

Claude uses these examples naturally inside articles.

This improves:

✓ originality

✓ trust

✓ EEAT signals

✓ SEO quality

Why These 3 Documents Matter

Together they teach Claude:

Tone

“How should I sound?”

Site Structure

“What pages should I link to?”

Experience

“What proof and examples should I use?”

This is what transforms:

generic AI content

into:

personalized SEO content.

How To Create The SEO Skill

Step 1. Open Claude

You need:

→ any Claude plan, including Free

Skills are available on Free, Pro, Max, Team and Enterprise plans. You do need code execution turned on in Settings > Capabilities, because Skills run inside it.

Step 2. Open Customize Tab

Go to:

→ Customize > Skills

→ click “+” to add a new skill (choose “Upload a skill” if you already have a skill ZIP)

Step 3. Enable “Skills Creator Skill”

Claude already provides:

→ prebuilt skill creator tool

Activate this first.

This helps generate the SEO skill setup.

Step 4. Prepare Your Main Prompt

This is the master instruction set.

The prompt should explain:

✓ article workflow

✓ SEO structure

✓ keyword handling

✓ research behavior

✓ tone handling

✓ outline approval process

✓ linking rules

Example SEO Skill Prompt Structure

Role

“You are an SEO content strategist and writer.”

Workflow

1. Ask for: → target keyword → article length → target audience → angle
2. Perform research.
3. Create article outline.
4. Suggest: → internal links → external sources
5. Wait for approval.
6. Write final article.

SEO Rules

✓ use headings properly

✓ optimize readability

✓ avoid keyword stuffing

✓ include FAQs

✓ add schema suggestions

✓ include internal links naturally

Tone Rules

✓ follow uploaded tone file

✓ avoid AI sounding phrases

✓ write naturally

Step 5. Upload Your Files

Attach:

✓ tone of voice document

✓ sitemap CSV

✓ experience document

Then press Enter.

Claude processes everything.

After a few minutes:

your skill gets created.

Save the skill.

What’s Inside The Skill (SKILL.md)

Whichever way you create it, the finished skill is a folder with a SKILL.md file. The file starts with a short YAML header, then your master prompt, and your three documents sit next to it in the same folder:

seo-content-writer/
  SKILL.md
  tone-of-voice.md
  sitemap.csv
  experience.md

---
name: seo-content-writer
description: Writes SEO blog articles in my brand voice. Asks for keyword, length, audience and angle, researches, proposes an outline with internal links from sitemap.csv, waits for approval, then writes. Use when asked to write or outline a blog post or SEO article.
---

Follow tone-of-voice.md for every sentence.
Only link to pages listed in sitemap.csv.
Use stories and results from experience.md as proof.

A few rules from Anthropic’s Agent Skills documentation:

→ the name uses lowercase letters, numbers and hyphens only (up to 64 characters) and can’t contain “anthropic” or “claude”

→ the description must say what the skill does and when to use it, because Claude reads only the name and description until a task matches

→ supporting files like your tone guide and sitemap are read only when needed, so they don’t use up context in every chat

Building it yourself? Zip the folder so the skill folder is at the root of the ZIP, then use “Upload a skill”. In Claude Code, drop the folder into ~/.claude/skills/ instead. Skills don’t sync between Claude apps, Claude Code and the API, so add it everywhere you plan to use it.

How To Use The SEO Skill

Step 1. Open New Chat

Type:

/

Then select:

your SEO skill.

You can also just ask for an article. Claude loads the skill on its own when your request matches the skill’s description.

Step 2. Claude Asks Questions

Instead of writing immediately,

the skill gathers context first.

Typical questions:

→ target keyword?

→ article length?

→ audience?

→ content angle?

→ search intent?

This improves content quality massively.

Step 3. Claude Performs Research

The skill:

✓ researches topic

✓ finds sources

✓ builds structure

✓ plans internal links

Then provides:

→ article outline

→ source list

→ linking plan

Step 4. Review The Outline

Before writing:

review everything.

Check:

✓ headings

✓ angles

✓ sources

✓ structure

Adjust anything you dislike.

Step 5. Generate The Article

After approval:

Claude writes the full SEO article.

Because the skill uses:

✓ tone file

✓ sitemap

✓ experience document

The output feels:

far more human and personalized.

What To Check After Generation

1. Tone

Does it sound like you?

Check:

✓ vocabulary

✓ sentence rhythm

✓ formatting style

2. External Links

AI sometimes invents fake links.

Verify:

✓ URLs exist

✓ sources are accurate

3. Internal Links

Ensure:

✓ links are relevant

✓ links go to real pages

✓ anchor text feels natural

Why Skills Beat Normal Prompts

Normal Prompt Workflow

Every new chat:

Claude forgets everything.

You paste:

→ tone

→ SEO instructions

→ sitemap

→ examples

Again and again.

Messy and inconsistent.

Claude Skills Workflow

Everything stays packaged:

✓ reusable

✓ consistent

✓ scalable

You activate once.

The workflow is ready instantly.

Biggest SEO Lesson From The Transcript

Perfect AI content alone is NOT enough.

Website speed matters heavily.

Google tracks:

✓ bounce rate

✓ load speed

✓ user experience

If your site loads slowly:

rankings suffer.

Mentioned Performance Solution

The transcript recommends:

→ WP Rocket

Main benefits:

✓ caching

✓ lazy loading

✓ CSS optimization

✓ JavaScript optimization

✓ Core Web Vitals improvements

Important because:

great content on a slow website still struggles.

Best Practices For Better Results

1. Use Real Writing Samples

Do not describe your style vaguely.

Give real examples.

2. Add Phrase Restrictions

Create:

“phrases I never want used”

Huge improvement for human sounding content.

3. Keep Sitemap Focused

Only include:

important SEO pages.

4. Add Real Stories

Claude writes better when:

real experiences exist.

5. Test On Familiar Topics First

You’ll notice:

✓ tone issues

✓ factual issues

✓ SEO problems faster

Then improve the skill gradually.

Want a ready-made option instead of building from scratch? Our agentic SEO Claude skill guide covers a finished SEO skill, and the practical guide to Claude Skills shows how to combine several skills into one workflow.

FAQ

Do I need a paid Claude plan to build an SEO skill?

No. Anthropic’s help center lists Skills on Free, Pro, Max, Team and Enterprise plans. You only need code execution turned on in Settings > Capabilities before you can add a custom skill.

What files should an SEO content skill include?

Three documents do most of the work: a tone of voice file built from your real writing, a mini sitemap CSV of the pages you want linked, and an experience document with case studies and results. They sit next to SKILL.md, which holds the name, description and master prompt.

How do I stop Claude from inventing links?

Give it a sitemap CSV and tell the skill to link only to pages listed there. Then check every external link by hand after generation, because AI can still produce URLs that don’t exist.

Can I use the same skill in Claude Code?

Yes. Put the skill folder in ~/.claude/skills/ (or .claude/skills/ inside a project) and Claude Code picks it up. Custom skills don’t sync between surfaces, so you add it separately in the Claude apps and in Claude Code.

How long should the tone of voice file be?

Long enough to show your real patterns: sentence length, formatting habits, phrases you use and phrases you never want. Building it from a handful of your best posts, scripts or emails works better than describing your style from memory.

Claude

Each button opens the assistant with the prompt already written, asking it to teach this article step by step, in simple words.

Explain with ChatGPT Claude Google AI Mode Grok Perplexity

Found this useful?

Mark BULDRR AI as a preferred source and our guides surface higher in your own Google results.

Add as a preferred source

Keep reading.

Workflows for this.