---
name: 30x-seo-content-writer
description: >
  SEO-optimized content generation. Two modes: plan mode (reads seo-plan
  output) or standalone mode (user provides keyword directly). Outputs
  markdown files. Use when user says "write SEO blog", "generate SEO content",
  "create blog post", or "SEO article".
allowed-tools:
  - WebFetch
  - Read
---

# 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

```markdown
# [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