guia-matthieu/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. 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
npx skills add https://github.com/guia-matthieu/clawfu-skills --skill 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.
Use this skill when you need to:
This skill is particularly valuable for:
Sources:
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
| 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 |
When invoked, I will guide you through the complete SEO content writing process:
Provide information about the content you want to create:
Example prompts:
Information that helps:
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 |
Ask these questions:
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 |
Intent alignment checklist:
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 |
For Experience:
For Expertise:
For Authoritativeness:
For Trustworthiness:
Your outline should include:
Comprehensive content covers what searchers expect. Find subtopics by:
# [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
Step 1: First Draft
Write freely without perfectionism. Focus on:
Step 2: Optimization Pass
Ensure SEO elements are in place:
Step 3: Readability Pass
Make content easy to consume:
| 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 |
The most important on-page element.
Best practices:
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]
Doesn't directly impact rankings but affects click-through rate.
Best practices:
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"].
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:
Good: /seo-content-writing-guide/
Bad: /2024/01/15/the-ultimate-guide-to-writing-seo-content-for-your-blog/
| 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 |
Before publishing, verify:
Experience signals:
Expertise signals:
Authority signals:
Trust signals:
Context: Writing a blog post for a project management SaaS targeting "project management best practices"
Keyword Analysis:
E-E-A-T Approach:
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:
/project-management-best-practices/Context: Writing SEO content for a category page selling running shoes
Keyword Analysis:
E-E-A-T Approach:
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:
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
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: ____________________
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
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
Primary Sources:
Additional Resources:
Take guia-matthieu/seo-content-writer from the repository into ~/.claude/skills for personal
use, or into .claude/skills inside a project.
The agent identifies a skill by the name field in its header. Two skills with the
same name cannot sit side by side — one of them will be ignored.