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 calendarSEO-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)
- [ ] 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