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:
- Topic/Title: Article topic
- Target Keyword: Primary keyword
- Secondary Keywords: Secondary keywords (optional)
- Search Intent: Informational / Commercial / Transactional
- Target Length: Short (800-1200) / Medium (1500-2000) / Long (2500+)
- 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
Blog Article (Markdown format)
- Full article with SEO optimization
- Meta title and description
- Suggested URL slug
SEO Checklist (verification)
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
After Generation
[PROTOCOL]: Update this header on changes, then check CLAUDE.md
1---2name: 30x-seo-content-writer3description: 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".4---56# SEO Content Writer78## What This Skill Does910Generate SEO-optimized blog articles.1112## Two Modes1314| Mode | Input | Use Case |15|------|-------|----------|16| **Plan Mode** | seo-plan output files | Have complete SEO strategy, write per calendar |17| **Standalone Mode** | User provides keyword | Quick single article, no full planning needed |1819---2021## Mode 1: Plan Mode2223### Prerequisites2425Have SEO plan (`/seo plan`):26- `CONTENT-CALENDAR.md` - Content calendar27- `SEO-STRATEGY.md` - Keyword and topic strategy2829### Process3031```32┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐33│ seo-plan │ │ │ │ │34│ output files │ ──> │ Generate │ ──> │ Markdown │35│ CONTENT-CALENDAR│ │ SEO Content │ │ blog article │36│ SEO-STRATEGY │ │ │ │ │37└─────────────────┘ └─────────────────┘ └─────────────────┘38```3940### Context from Plan4142| Info | Source | Usage |43|------|--------|-------|44| **Target keywords** | SEO-STRATEGY.md | Title, H2, body optimization |45| **Topic clusters** | SEO-STRATEGY.md | Internal link planning |46| **Competitor analysis** | COMPETITOR-ANALYSIS.md | Differentiation angle |4748---4950## Mode 2: Standalone Mode5152### When to Use5354- Just want to quickly write one article55- Don't have a complete SEO plan56- Already know the target keyword5758### Required Input5960Ask user:61621. **Topic/Title**: Article topic632. **Target Keyword**: Primary keyword643. **Secondary Keywords**: Secondary keywords (optional)654. **Search Intent**: Informational / Commercial / Transactional665. **Target Length**: Short (800-1200) / Medium (1500-2000) / Long (2500+)676. **CTA Goal**: What action should readers take?6869---7071## Content Generation7273### Article Structure7475```markdown76# [H1: Include primary keyword, 50-60 chars]7778[Hook: Engaging first paragraph, mention keyword naturally]7980## [H2: Section with keyword variation]8182[Content with semantic keywords, 2-4 paragraphs]8384### [H3: Subsection if needed]8586[Supporting content]8788## [H2: Another main section]8990[Continue pattern...]9192## Conclusion / Key Takeaways9394[Summary, reiterate value, include CTA]95```9697### SEO Requirements Checklist9899| Element | Requirement |100|---------|-------------|101| **Title (H1)** | Include primary keyword, 50-60 characters |102| **Meta Description** | Include keyword, 150-160 characters, compelling |103| **URL Slug** | Short, keyword-rich, hyphenated |104| **First 100 Words** | Include primary keyword naturally |105| **Headings** | H2s include keyword variations, logical hierarchy |106| **Keyword Density** | 1-2%, natural placement |107| **Internal Links** | 3-5 relevant internal links (placeholder: [Internal: topic]) |108| **External Links** | 2-3 authoritative sources |109| **Images** | Suggest placements with alt text descriptions |110| **Readability** | Short paragraphs, bullet lists, scannable |111112### E-E-A-T Signals to Include113114| Signal | How to Include |115|--------|----------------|116| **Experience** | First-hand examples, case studies, "we tested" |117| **Expertise** | Technical depth, accurate information, citations |118| **Authoritativeness** | Cite reputable sources, link to studies |119| **Trustworthiness** | Clear attribution, honest claims, no exaggeration |120121### AI Citation Readiness (GEO)122123For AI search visibility:124- Include clear, quotable definitions125- Use structured formats (tables, lists)126- Answer questions directly in the first sentence127- Include specific data points and statistics128129---130131## Output Format132133### Deliverables1341351. **Blog Article** (Markdown format)136 - Full article with SEO optimization137 - Meta title and description138 - Suggested URL slug1391402. **SEO Checklist** (verification)141 - [ ] Primary keyword in title142 - [ ] Primary keyword in first 100 words143 - [ ] H2s with keyword variations144 - [ ] Internal link placeholders145 - [ ] External authoritative links146 - [ ] Image suggestions with alt text147 - [ ] CTA included148149---150151## Commands152153| Command | Mode |154|---------|------|155| `/seo content-writer` | Auto-detect (plan mode if seo-plan output exists, otherwise standalone) |156| `/seo content-writer "topic"` | Standalone mode, directly specify topic |157158---159160## Integration with Other Skills161162| Skill | When to Use |163|-------|-------------|164| **seo-plan** | Create plan first, then use plan mode to generate content |165| **seo-internal-links suggest** | Generate internal link suggestions after writing |166| **seo-content-audit** | Audit quality after writing |167168---169170## Quality Gates171172### Before Generation173- [ ] Target keyword confirmed174- [ ] Search intent understood175- [ ] Length decided176177### After Generation178- [ ] Keyword naturally integrated (not stuffed)179- [ ] E-E-A-T signals present180- [ ] Readability appropriate for audience181- [ ] CTA aligned with business goal182- [ ] No factual claims without sources183184[PROTOCOL]: Update this header on changes, then check CLAUDE.md