seo-content-writer

$npx mdskill add guia-matthieu/clawfu-skills/seo-content-writer

Writes SEO-optimized content using Ahrefs, Moz, and E-E-A-T frameworks for blogs, guides, and product pages.

  • Helps create content that ranks on Google and satisfies both search engines and readers.
  • Integrates with proven frameworks from Ahrefs, Moz, and Google's E-E-A-T guidelines.
  • Decides based on SEO best practices to produce helpful, people-first content.
  • Delivers results as written content for various formats like blog posts and how-to guides.
SKILL.md
.github/skills/seo-content-writerView on GitHub ↗
---
name: seo-content-writer
description: "Write search-optimized content that ranks on Google using proven frameworks from Ahrefs, Moz, and Google's E-E-A-T guidelines—create helpful, people-first content that satisfies both search engines and readers. Use when: **Write blog posts** optimized for search engines; **Create pillar content** for topical authority; **Optimize existing content** for better rankings; **Write product or service pages** that rank; **Create how-to guides** and tutorials"
license: MIT
metadata:
  author: ClawFu
  version: 1.0.0
  mcp-server: "@clawfu/mcp-skills"
---

# SEO Content Writer

> Write search-optimized content that ranks on Google using proven frameworks from Ahrefs, Moz, and Google's E-E-A-T guidelines—create helpful, people-first content that satisfies both search engines and readers.

## When to Use This Skill

Use this skill when you need to:

- **Write blog posts** optimized for search engines
- **Create pillar content** for topical authority
- **Optimize existing content** for better rankings
- **Write product or service pages** that rank
- **Create how-to guides** and tutorials
- **Develop content briefs** for writers
- **Audit content** for E-E-A-T compliance
- **Build topical clusters** around key themes

This skill is particularly valuable for:
- Content marketers creating SEO-driven content
- Bloggers wanting organic traffic
- SaaS companies building content marketing engines
- E-commerce sites needing category and product content
- Agencies producing client content at scale
- Anyone who wants their content to be found on Google

---

## Methodology Foundation

**Sources:**
- Ahrefs - "SEO Writing: 8 Steps to Create Search-Optimized Content"
- Google Search Quality Rater Guidelines (E-E-A-T framework)
- Moz SEO Learning Center

**Core Principle:** SEO writing is about creating the best possible answer to a given query, presented in a way that's easily understood and skimmable, while demonstrating Experience, Expertise, Authoritativeness, and Trustworthiness.

> "Great writing should feel hard. If you can crank out an article by opening a few browser tabs, so can everyone else. But interview someone, read a book, find an esoteric research paper, or collect some data… and your willingness to do something difficult gives you an edge." — Ryan Law, Ahrefs

---


## What Claude Does vs What You Decide

| Claude Does | You Decide |
|-------------|------------|
| Structures production workflow | Final creative direction |
| Suggests technical approaches | Equipment and tool choices |
| Creates templates and checklists | Quality standards |
| Identifies best practices | Brand/voice decisions |
| Generates script outlines | Final script approval |

## What This Skill Does

When invoked, I will guide you through the complete SEO content writing process:

1. **Research the keyword opportunity** - Find topics worth writing about
2. **Analyze search intent** - Understand what searchers really want
3. **Plan for E-E-A-T** - Build expertise and trust signals
4. **Create a comprehensive outline** - Structure for both users and search engines
5. **Write optimized content** - Balance readability with SEO best practices
6. **Optimize on-page elements** - Title tags, meta descriptions, headers
7. **Add internal links** - Connect to your content ecosystem
8. **Review for quality signals** - Final E-E-A-T checklist

---

## How to Use

Provide information about the content you want to create:

**Example prompts:**

- "Write an SEO-optimized article about [topic]"
- "Create a content brief for [keyword]"
- "Optimize this existing content for search: [paste content]"
- "Help me structure a pillar page for [topic]"
- "Analyze this keyword and suggest a content approach"
- "Review this content for E-E-A-T compliance"

**Information that helps:**

- Target keyword(s)
- Your website/business context
- Target audience
- Existing content on the topic (yours or competitors')
- Any unique expertise or data you have
- Word count expectations
- Content type (blog post, guide, pillar page, etc.)

---

## Instructions

### Phase 1: Keyword Research & Opportunity Assessment

#### Finding Keywords Worth Targeting

Before writing, ensure people are actually searching for your topic.

**Keyword evaluation criteria:**

| Factor | What to Look For |
|--------|------------------|
| **Search volume** | Monthly searches (varies by niche) |
| **Keyword difficulty** | Can you realistically rank? |
| **Business relevance** | Does it connect to your offering? |
| **Search intent match** | Can you satisfy what searchers want? |
| **Traffic potential** | Total opportunity including related terms |

#### Quick Keyword Qualification

Ask these questions:
- Does this keyword have search volume?
- Can I create content better than what currently ranks?
- Will this traffic benefit my business?
- Do I have (or can I develop) expertise on this topic?

---

### Phase 2: Search Intent Analysis

#### Understanding What Searchers Want

Search intent is the "why" behind a query. Misaligning with intent means you won't rank, regardless of content quality.

**The Four Types of Search Intent:**

| Intent | User Goal | Content Format |
|--------|-----------|----------------|
| **Informational** | Learn something | Blog posts, guides, how-tos |
| **Navigational** | Find a specific page | Brand pages, homepage |
| **Commercial** | Research before buying | Comparisons, reviews, "best of" |
| **Transactional** | Make a purchase | Product pages, pricing pages |

#### How to Analyze Intent

1. **Google the keyword** - Look at what currently ranks
2. **Identify the dominant format** - Listicle? Guide? Video?
3. **Note common elements** - What do all top results include?
4. **Find the content gap** - What's missing?

**Intent alignment checklist:**
- [ ] Does my content format match top results?
- [ ] Am I answering the same core question?
- [ ] Do I cover the same subtopics?
- [ ] Am I at the same depth level?

---

### Phase 3: E-E-A-T Planning

#### Building Trust Signals Into Your Content

Google evaluates content on four dimensions:

| Component | Definition | How to Demonstrate |
|-----------|------------|-------------------|
| **Experience** | First-hand involvement with topic | Personal stories, original photos, case studies |
| **Expertise** | Knowledge and skill in the field | Credentials, detailed explanations, accuracy |
| **Authoritativeness** | Recognition as a leading source | Backlinks, mentions, awards, industry presence |
| **Trustworthiness** | Accuracy, honesty, reliability | Citations, transparency, updated info, reviews |

#### E-E-A-T Content Tactics

**For Experience:**
- Include personal anecdotes relevant to the topic
- Use original images and screenshots
- Reference specific situations you've encountered
- Share results you've personally achieved

**For Expertise:**
- Add detailed author bio with credentials
- Include "Reviewed by" expert validation for YMYL topics
- Cite specific data, studies, and sources
- Demonstrate deep understanding (not surface-level)

**For Authoritativeness:**
- Link to and cite authoritative sources
- Reference your own original research
- Mention relevant credentials or experience
- Include expert quotes or interviews

**For Trustworthiness:**
- Provide accurate, fact-checked information
- Update content when information changes
- Be transparent about limitations or caveats
- Include proper citations and references

---

### Phase 4: Content Outline Creation

#### Building a Comprehensive Structure

Your outline should include:

1. **Working title** (optimize later)
2. **Target keyword** and related keywords
3. **Search intent summary**
4. **Unique angle** (what makes your content different)
5. **H2 sections** covering all subtopics searchers expect
6. **H3 subsections** for detailed breakdowns
7. **Key points** to cover in each section
8. **Original elements** (data, examples, case studies)

#### Finding Subtopics to Cover

Comprehensive content covers what searchers expect. Find subtopics by:

1. **Analyzing competitor content** - What do top pages include?
2. **Reviewing "People Also Ask"** - Common questions to answer
3. **Checking related searches** - Additional angles to cover
4. **Using content gap analysis** - Keywords competitors rank for

#### Outline Template

```
# [Working Title with Keyword]

Target Keyword: [primary keyword]
Secondary Keywords: [list 3-5]
Search Intent: [informational/commercial/etc.]
Unique Angle: [what makes this different]

## Introduction
- Hook
- Problem/opportunity statement
- What reader will learn
- [Establish expertise/experience]

## H2: [First Major Section]
### H3: [Subsection]
- Key points
- Example or data

### H3: [Subsection]
- Key points

## H2: [Second Major Section]
[continue pattern]

## H2: Examples / Case Studies
- Real-world application 1
- Real-world application 2

## H2: Common Mistakes / FAQs
- Address common questions

## Conclusion
- Summary
- Next steps / CTA
```

---

### Phase 5: Writing Optimized Content

#### The Writing Process

**Step 1: First Draft**
Write freely without perfectionism. Focus on:
- Getting all ideas out
- Following your outline
- Maintaining your unique angle

**Step 2: Optimization Pass**
Ensure SEO elements are in place:
- Primary keyword in first 100 words
- Keywords used naturally throughout
- Proper header structure (H1 → H2 → H3)
- Sufficient depth on each section

**Step 3: Readability Pass**
Make content easy to consume:
- Short paragraphs (2-4 sentences)
- Bullet points and numbered lists
- Tables for comparing information
- Visual breaks every 300-400 words

#### Writing Best Practices

| Do This | Avoid This |
|---------|------------|
| Write in active voice | Passive constructions |
| Use "you" directly | Third-person distance |
| Break up long sections | Walls of text |
| Include specific examples | Vague generalizations |
| Define technical terms | Unexplained jargon |
| Show, don't just tell | Abstract claims without proof |

#### Content Quality Checklist

- [ ] Does it fully answer the searcher's question?
- [ ] Is it more comprehensive than competitors?
- [ ] Does it include original insights or data?
- [ ] Is the information accurate and current?
- [ ] Would an expert approve of this content?
- [ ] Is it actually helpful to the reader?

---

### Phase 6: On-Page Optimization

#### Title Tag

The most important on-page element.

**Best practices:**
- Include primary keyword (preferably near the beginning)
- Keep under 60 characters
- Make it compelling (not just keyword-stuffed)
- Match search intent
- Stand out from competitors

**Title tag formulas:**

```
[Number] [Adjective] Ways to [Desired Outcome]
How to [Achieve Result] in [Timeframe]
[Topic]: The Complete Guide for [Year]
[Topic] vs [Topic]: [Angle]
What Is [Topic]? [Benefit or Hook]
```

#### Meta Description

Doesn't directly impact rankings but affects click-through rate.

**Best practices:**
- Stay under 155-160 characters
- Include primary keyword naturally
- Add a call-to-action
- Expand on the title (don't repeat it)
- Address the searcher directly

**Meta description template:**
```
Learn [what they'll learn]. This guide covers [key topics]
to help you [achieve outcome]. [CTA like "Read more" or "Get started"].
```

#### Header Structure

Proper header hierarchy helps both users and Google understand your content.

```
H1: Main Title (only one per page)
  H2: Major Section 1
    H3: Subsection
    H3: Subsection
  H2: Major Section 2
    H3: Subsection
  H2: Major Section 3
```

**Header tips:**
- Include keywords naturally (not forced)
- Make headers descriptive and specific
- Use headers to enable scanning
- Front-load important words

#### URL Structure

- Keep short and descriptive
- Include primary keyword
- Use hyphens between words
- Avoid dates (unless news content)
- Remove unnecessary words (a, the, and)

**Good:** `/seo-content-writing-guide/`
**Bad:** `/2024/01/15/the-ultimate-guide-to-writing-seo-content-for-your-blog/`

---

### Phase 7: Internal Linking

#### Why Internal Links Matter

- Help Google discover and understand new pages
- Pass link equity to important pages
- Keep users engaged on your site
- Build topical clusters

#### Internal Linking Best Practices

| Do | Don't |
|----|-------|
| Link from relevant context | Force unnatural links |
| Use descriptive anchor text | Use "click here" |
| Link to related content | Link to random pages |
| Update old posts with links to new | Forget about older content |
| Prioritize important pages | Spread links equally |

#### After Publishing Checklist

- [ ] Add internal links from existing relevant content
- [ ] Link to related posts within the new content
- [ ] Update pillar pages to reference new content
- [ ] Check that important pages have sufficient internal links

---

### Phase 8: E-E-A-T Review

#### Final Quality Check

Before publishing, verify:

**Experience signals:**
- [ ] Personal experience or case studies included
- [ ] Original images/screenshots where relevant
- [ ] Specific examples from real situations

**Expertise signals:**
- [ ] Author bio with relevant credentials
- [ ] Accurate, well-researched information
- [ ] Appropriate depth for the topic

**Authority signals:**
- [ ] Cites authoritative external sources
- [ ] Links to supporting evidence
- [ ] Positions author/brand as knowledgeable

**Trust signals:**
- [ ] Information is current and accurate
- [ ] Sources are properly cited
- [ ] No misleading claims
- [ ] Clear about any limitations or caveats

---

## Examples

### Example 1: B2B SaaS Blog Post

**Context:** Writing a blog post for a project management SaaS targeting "project management best practices"

**Keyword Analysis:**
- Primary: "project management best practices"
- Secondary: "project management tips," "how to manage projects effectively"
- Intent: Informational (people want to learn techniques)
- Difficulty: Medium-high (competitive but achievable)

**E-E-A-T Approach:**
- **Experience:** Include examples from real projects the team has managed
- **Expertise:** Author is a PMP-certified project manager with 10+ years experience
- **Authority:** Reference PMI standards and cite recognized methodologies
- **Trust:** Include data from industry studies, link to authoritative sources

**Outline:**

```
# 15 Project Management Best Practices That Actually Work [2024]

## Introduction
- Hook: Why most projects fail (cite statistic)
- Promise: Practices that prevent failure

## What Makes a Practice "Best"?
- Evidence-based effectiveness
- Scalability across project types

## H2: Planning Best Practices
### Define clear objectives with SMART goals
### Create a realistic timeline with buffers
### Identify risks before they become problems

## H2: Execution Best Practices
### Daily standups that don't waste time
### Document decisions, not just tasks
### Build in regular check-ins

## H2: Team Management Best Practices
### Match tasks to strengths
### Create psychological safety
### Celebrate small wins

## H2: Tools and Systems Best Practices
### Choose tools that match your workflow
### Automate repetitive tasks
### Maintain a single source of truth

## H2: Case Study: How [Company] Reduced Project Delays by 40%
- Real example with specific results

## H2: Common Mistakes to Avoid
- Planning paralysis
- Skipping stakeholder alignment
- Ignoring early warning signs

## Conclusion
- Summary of key practices
- CTA: Try our project management tool
```

**On-Page Optimization:**
- Title: "15 Project Management Best Practices That Actually Work [2024]"
- Meta: "Discover proven project management best practices from PMP experts. Learn planning, execution, and team management techniques that reduce delays and improve outcomes."
- URL: `/project-management-best-practices/`

---

### Example 2: E-Commerce Category Page

**Context:** Writing SEO content for a category page selling running shoes

**Keyword Analysis:**
- Primary: "best running shoes"
- Secondary: "running shoes for beginners," "cushioned running shoes"
- Intent: Commercial (researching before buying)
- Format needed: Buyer's guide with product recommendations

**E-E-A-T Approach:**
- **Experience:** Staff have tested shoes; include first-hand impressions
- **Expertise:** Partner with a podiatrist or running coach for expert input
- **Authority:** Link to running publications, shoe testing methodology
- **Trust:** Honest pros/cons, clear affiliate disclosure, real customer reviews

**Content Structure:**

```
# Best Running Shoes of 2024: Tested by Runners

## Quick Picks: Our Top Recommendations
[Table with top picks by category]

## How We Test Running Shoes
- Miles run in each shoe
- Testing on different surfaces
- Runner profile (foot type, experience)

## Best Overall: [Shoe Name]
- Expert verdict (2-3 sentences)
- Pros and cons (bullets)
- Best for: [runner type]
- [Image with runner wearing shoes]

## Best for Beginners: [Shoe Name]
[Same structure]

## Best Cushioned: [Shoe Name]
[Same structure]

## Best Value: [Shoe Name]
[Same structure]

## How to Choose Running Shoes
### Understanding Your Gait
### Cushioning vs. Responsiveness
### When to Replace Running Shoes

## Expert Tips from [Podiatrist Name]
[Quote and advice from expert]

## FAQ
- How often should I replace running shoes?
- What's the difference between road and trail shoes?
- Do expensive shoes make a difference?

## Methodology
- How we selected shoes to test
- Our testing process
- Our scoring criteria
```

**Trust Signals:**
- "Reviewed by [Podiatrist Name], DPM"
- Real testing methodology disclosed
- Customer reviews integrated
- Clear affiliate disclosure

---

## Checklists & Templates

### Pre-Writing Research Checklist

```
KEYWORD RESEARCH
□ Primary keyword identified
□ Search volume verified
□ Keyword difficulty assessed
□ Business relevance confirmed
□ Secondary keywords listed (3-5)

SEARCH INTENT ANALYSIS
□ Top 10 results analyzed
□ Dominant content format identified
□ Common subtopics noted
□ Content gaps identified
□ Unique angle determined

E-E-A-T PLANNING
□ Experience element identified (what can you share?)
□ Expertise element identified (credentials, knowledge)
□ Authority signals planned (sources, citations)
□ Trust signals planned (accuracy, transparency)
```

### Content Brief Template

```
CONTENT BRIEF

Target Keyword: ____________________
Secondary Keywords: ____________________
Word Count Target: ____________________
Content Type: ____________________

SEARCH INTENT
What searchers want: ____________________
Content format needed: ____________________

COMPETITOR ANALYSIS
Top 3 competing URLs:
1. ____________________
2. ____________________
3. ____________________

What they do well: ____________________
What's missing: ____________________

UNIQUE ANGLE
Our differentiator: ____________________
Original data/experience: ____________________

REQUIRED SECTIONS
□ ____________________
□ ____________________
□ ____________________

E-E-A-T REQUIREMENTS
Author credentials: ____________________
Expert review needed: □ Yes □ No
Original elements: ____________________
Sources to cite: ____________________
```

### On-Page SEO Checklist

```
TITLE TAG
□ Primary keyword included
□ Under 60 characters
□ Compelling and clickable
□ Matches search intent

META DESCRIPTION
□ Under 155 characters
□ Includes keyword naturally
□ Has call-to-action
□ Expands on title

HEADERS
□ Only one H1 (page title)
□ H2s for major sections
□ H3s for subsections
□ Keywords in headers (naturally)

CONTENT
□ Keyword in first 100 words
□ Keywords used naturally throughout
□ Comprehensive coverage
□ Original insights or data
□ Proper formatting (lists, tables)
□ Images with alt text

URL
□ Short and descriptive
□ Includes keyword
□ Uses hyphens

LINKS
□ Internal links to related content
□ External links to authoritative sources
□ Anchor text is descriptive
```

### E-E-A-T Audit Checklist

```
EXPERIENCE
□ First-hand experience demonstrated
□ Original photos/screenshots included
□ Personal anecdotes or case studies
□ Specific examples from real situations

EXPERTISE
□ Author bio with credentials present
□ Expert review for YMYL topics
□ Demonstrates deep topic knowledge
□ Technical accuracy verified

AUTHORITATIVENESS
□ Cites recognized authorities
□ Links to reputable sources
□ References original research (if applicable)
□ Industry recognition mentioned

TRUSTWORTHINESS
□ Information is accurate and current
□ Sources properly cited
□ No misleading claims
□ Transparent about limitations
□ Contact information accessible
□ Privacy policy/terms present
```

---

## Skill Boundaries

### What This Skill Does Well
- Structuring audio production workflows
- Providing technical guidance
- Creating quality checklists
- Suggesting creative approaches

### What This Skill Cannot Do
- Replace audio engineering expertise
- Make subjective creative decisions
- Access or edit audio files directly
- Guarantee commercial success

## References

**Primary Sources:**
- Ahrefs Blog: "SEO Writing: 8 Steps to Create Search-Optimized Content"
- Google Search Quality Rater Guidelines
- Moz SEO Learning Center: On-Page SEO Guide
- Google Search Central: Creating Helpful Content

**Additional Resources:**
- Hemingway Editor (readability)
- Grammarly (grammar and clarity)
- Ahrefs/Semrush (keyword research)
- Clearscope/Surfer SEO (content optimization)

---

## Related Skills

- **skyscraper-technique** - Building linkable content assets
- **content-writing** - General content writing principles
- **copy-frameworks** - Persuasive writing structures
- **keyword-strategy** - Comprehensive keyword research
- **landing-page-copy** - Conversion-focused page copy
- **headline-formulas** - Compelling title creation
More from guia-matthieu/clawfu-skills