SEO Content Writer

What This Skill Does

Generate SEO-optimized blog articles.

Two Modes

Mode	Input	Use Case
Plan Mode	seo-plan output files	Have complete SEO strategy, write per calendar
Standalone Mode	User provides keyword	Quick single article, no full planning needed

---

Mode 1: Plan Mode

Prerequisites

Have SEO plan (/seo plan):

• CONTENT-CALENDAR.md - Content calendar
• SEO-STRATEGY.md - Keyword and topic strategy

Process

┌─────────────────┐     ┌─────────────────┐     ┌─────────────────┐
│   seo-plan      │     │                 │     │                 │
│   output files  │ ──> │    Generate     │ ──> │   Markdown      │
│ CONTENT-CALENDAR│     │   SEO Content   │     │   blog article  │
│ SEO-STRATEGY    │     │                 │     │                 │
└─────────────────┘     └─────────────────┘     └─────────────────┘

Context from Plan

Info	Source	Usage
Target keywords	SEO-STRATEGY.md	Title, H2, body optimization
Topic clusters	SEO-STRATEGY.md	Internal link planning
Competitor analysis	COMPETITOR-ANALYSIS.md	Differentiation angle

---

Mode 2: Standalone Mode

When to Use

• Just want to quickly write one article
• Don't have a complete SEO plan
• Already know the target keyword

Required Input

Ask user:

1. Topic/Title: Article topic
2. Target Keyword: Primary keyword
3. Secondary Keywords: Secondary keywords (optional)
4. Search Intent: Informational / Commercial / Transactional
5. Target Length: Short (800-1200) / Medium (1500-2000) / Long (2500+)
6. CTA Goal: What action should readers take?

---

Content Generation

Article Structure

# [H1: Include primary keyword, 50-60 chars]

[Hook: Engaging first paragraph, mention keyword naturally]

## [H2: Section with keyword variation]

[Content with semantic keywords, 2-4 paragraphs]

### [H3: Subsection if needed]

[Supporting content]

## [H2: Another main section]

[Continue pattern...]

## Conclusion / Key Takeaways

[Summary, reiterate value, include CTA]

SEO Requirements Checklist

Element	Requirement
Title (H1)	Include primary keyword, 50-60 characters
Meta Description	Include keyword, 150-160 characters, compelling
URL Slug	Short, keyword-rich, hyphenated
First 100 Words	Include primary keyword naturally
Headings	H2s include keyword variations, logical hierarchy
Keyword Density	1-2%, natural placement
Internal Links	3-5 relevant internal links (placeholder: [Internal: topic])
External Links	2-3 authoritative sources
Images	Suggest placements with alt text descriptions
Readability	Short paragraphs, bullet lists, scannable

E-E-A-T Signals to Include

Signal	How to Include
Experience	First-hand examples, case studies, "we tested"
Expertise	Technical depth, accurate information, citations
Authoritativeness	Cite reputable sources, link to studies
Trustworthiness	Clear attribution, honest claims, no exaggeration

AI Citation Readiness (GEO)

For AI search visibility:

• Include clear, quotable definitions
• Use structured formats (tables, lists)
• Answer questions directly in the first sentence
• Include specific data points and statistics

---

Output Format

Deliverables

1. Blog Article (Markdown format)

   • Full article with SEO optimization
   • Meta title and description
   • Suggested URL slug

2. SEO Checklist (verification)

   • Primary keyword in title
   • Primary keyword in first 100 words
   • H2s with keyword variations
   • Internal link placeholders
   • External authoritative links
   • Image suggestions with alt text
   • CTA included

---

Commands

Command	Mode
/seo content-writer	Auto-detect (plan mode if seo-plan output exists, otherwise standalone)
/seo content-writer "topic"	Standalone mode, directly specify topic

---

Integration with Other Skills

Skill	When to Use
seo-plan	Create plan first, then use plan mode to generate content
seo-internal-links suggest	Generate internal link suggestions after writing
seo-content-audit	Audit quality after writing

---

Quality Gates

Before Generation

• Target keyword confirmed
• Search intent understood
• Length decided

After Generation

• Keyword naturally integrated (not stuffed)
• E-E-A-T signals present
• Readability appropriate for audience
• CTA aligned with business goal
• No factual claims without sources

[PROTOCOL]: Update this header on changes, then check CLAUDE.md