SEO Content Writer
SEO & GEO Skills Library · 20 skills for SEO + GEO · Install all: npx skills add aaron-he-zhu/seo-geo-claude-skills
Research · keyword-research · competitor-analysis · serp-analysis · content-gap-analysis
Build · seo-content-writer · geo-content-optimizer · meta-tags-optimizer · schema-markup-generator
Optimize · on-page-seo-auditor · technical-seo-checker · internal-linking-optimizer · content-refresher
Monitor · rank-tracker · backlink-analyzer · performance-reporter · alert-manager
Cross-cutting · content-quality-auditor · domain-authority-auditor · entity-optimizer · memory-management
This skill creates search-engine-optimized content that ranks well while providing genuine value to readers. It applies proven SEO copywriting techniques, proper keyword integration, and optimal content structure.
When to Use This Skill
- Writing blog posts targeting specific keywords
- Creating landing pages optimized for search
- Developing pillar content for topic clusters
- Writing product descriptions for e-commerce
- Creating service pages for local SEO
- Producing how-to guides and tutorials
- Writing comparison and review articles
What This Skill Does
- Keyword Integration: Naturally incorporates target and related keywords
- Structure Optimization: Creates scannable, well-organized content
- Title & Meta Creation: Writes compelling, click-worthy titles
- Header Optimization: Uses strategic H1-H6 hierarchy
- Internal Linking: Suggests relevant internal link opportunities
- Readability Enhancement: Ensures content is accessible and engaging
- Featured Snippet Optimization: Formats for SERP feature opportunities
How to Use
Basic Content Creation
Write an SEO-optimized article about [topic] targeting the keyword [keyword]
Create a blog post for [topic] with these keywords: [keyword list]
With Specific Requirements
Write a 2,000-word guide about [topic] targeting [keyword],
include FAQ section for featured snippets
Content Briefs
Here's my content brief: [brief]. Write SEO-optimized content following this outline.
Data Sources
See CONNECTORS.md for tool category placeholders.
With ~~SEO tool + ~~search console connected:
Automatically pull keyword metrics (search volume, difficulty, CPC), competitor content analysis (top-ranking pages, content length, common topics), SERP features (featured snippets, PAA questions), and keyword opportunities (related keywords, question-based queries).
With manual data only:
Ask the user to provide:
- Target primary keyword and 3-5 secondary keywords
- Target audience and search intent (informational/commercial/transactional)
- Target word count and desired tone
- Any competitor URLs or content examples to reference
Proceed with the full workflow using provided data. Note in the output which metrics are from automated collection vs. user-provided data.
Instructions
When a user requests SEO content:
Gather Requirements
Confirm or ask for:
### Content Requirements
**Primary Keyword**: [main keyword]
**Secondary Keywords**: [2-5 related keywords]
**Target Word Count**: [length]
**Content Type**: [blog/guide/landing page/etc.]
**Target Audience**: [who is this for]
**Search Intent**: [informational/commercial/transactional]
**Tone**: [professional/casual/technical/friendly]
**CTA Goal**: [what action should readers take]
**Competitor URLs**: [top ranking content to beat]
Load CORE-EEAT Quality Constraints
Before writing, load content quality standards from the CORE-EEAT Benchmark:
### CORE-EEAT Pre-Write Checklist
**Content Type**: [identified from requirements above]
**Loaded Constraints** (high-weight items for this content type):
Apply these standards while writing:
| ID | Standard | How to Apply |
|----|----------|-------------|
| C01 | Intent Alignment | Title promise must match content delivery |
| C02 | Direct Answer | Core answer in first 150 words |
| C06 | Audience Targeting | State "this article is for..." |
| C10 | Semantic Closure | Conclusion answers opening question + next steps |
| O01 | Heading Hierarchy | H1→H2→H3, no level skipping |
| O02 | Summary Box | Include TL;DR or Key Takeaways |
| O06 | Section Chunking | Each section single topic; paragraphs 3–5 sentences |
| O09 | Information Density | No filler; consistent terminology |
| R01 | Data Precision | ≥5 precise numbers with units |
| R02 | Citation Density | ≥1 external citation per 500 words |
| R04 | Evidence-Claim Mapping | Every claim backed by evidence |
| R07 | Entity Precision | Full names for people/orgs/products |
| C03 | Query Coverage | Cover ≥3 query variants (synonyms, long-tail) |
| O08 | Anchor Navigation | Table of contents with jump links |
| O10 | Multimedia Structure | Images/videos have captions and carry information |
| E07 | Practical Tools | Include downloadable templates, checklists, or calculators |
_These 16 items apply across all content types. For content-type-specific dimension weights, see the Content-Type Weight Table in [core-eeat-benchmark.md](../../references/core-eeat-benchmark.md)._
_Full 80-item benchmark: [references/core-eeat-benchmark.md](../../references/core-eeat-benchmark.md)_
_For complete content quality audit: use [content-quality-auditor](../../cross-cutting/content-quality-auditor/)_
Research and Plan
Before writing:
### Content Research
**SERP Analysis**:
- Top results format: [what's ranking]
- Average word count: [X] words
- Common sections: [list]
- SERP features: [snippets, PAA, etc.]
**Keyword Map**:
- Primary: [keyword] - use in title, H1, intro, conclusion
- Secondary: [keywords] - use in H2s, body paragraphs
- LSI/Related: [terms] - sprinkle naturally throughout
- Questions: [PAA questions] - use as H2/H3s or FAQ
**Content Angle**:
[What unique perspective or value will this content provide?]
Create Optimized Title
### Title Optimization
**Requirements**:
- Include primary keyword (preferably at start)
- Under 60 characters for full SERP display
- Compelling and click-worthy
- Match search intent
**Title Options**:
1. [Title option 1] ([X] chars)
- Keyword position: [front/middle]
- Power words: [list]
2. [Title option 2] ([X] chars)
- Keyword position: [front/middle]
- Power words: [list]
**Recommended**: [Best option with reasoning]
Write Meta Description
### Meta Description
**Requirements**:
- 150-160 characters
- Include primary keyword naturally
- Include call-to-action
- Compelling and specific
**Meta Description**:
"[Description text]" ([X] characters)
**Elements included**:
- ✅ Primary keyword
- ✅ Value proposition
- ✅ CTA or curiosity hook
Structure Content and Write
Structure: H1 (primary keyword, one per page) > Introduction (100-150 words, hook + promise + keyword in first 100 words) > H2 sections (secondary keywords/questions) > H3 sub-topics > FAQ section > Conclusion (summary + keyword + CTA).
Apply On-Page SEO Best Practices
Follow the on-page SEO checklist (keyword placement, content quality, readability, technical elements) and the content writing template (H1 with keyword, hook, sections with H2/H3, FAQ, conclusion with CTA).
Reference: See references/seo-writing-checklist.md for the full on-page SEO checklist, content writing template, and featured snippet optimization patterns.
Key requirements while writing:
- Primary keyword in title, H1, first 100 words, at least one H2, and conclusion
- Paragraphs of 3-5 sentences; varied sentence length; bullet points and bold key phrases
- Internal links (2-5) and external authoritative links (2-3)
- FAQ section with 40-60 word answers for featured snippet opportunity
- Optimize for definition, list, table, and how-to snippets where applicable
Add Internal/External Links
### Link Recommendations
**Internal Links** (include 2-5):
1. "[anchor text]" → [/your-page-url] (relevant because: [reason])
2. "[anchor text]" → [/your-page-url] (relevant because: [reason])
**External Links** (include 2-3 authoritative sources):
1. "[anchor text]" → [authoritative-source.com] (supports: [claim])
2. "[anchor text]" → [authoritative-source.com] (supports: [claim])
Final SEO Review and CORE-EEAT Self-Check
Score content across 10 SEO factors (title, meta description, H1, keyword placement, H2s, internal links, external links, FAQ, readability, word count) and produce an Overall SEO Score out of 10.
Then verify the 16 CORE-EEAT pre-write constraints (C01, C02, C06, C10, O01, O02, O06, O09, R01, R02, R04, R07, C03, O08, O10, E07) with pass/warning/fail status. List items needing attention.
For full 80-item audit, use content-quality-auditor
Validation Checkpoints
Input Validation
Output Validation
Example
User: "Write an SEO-optimized article about 'email marketing best practices' targeting small businesses"
Reference: See references/seo-writing-checklist.md for the full example output demonstrating a complete SEO article with meta description, H1/H2/H3 hierarchy, statistics with citations, comparison tables, FAQ section, and conclusion with CTA.
The example output demonstrates: keyword in H1 and first 100 words, statistics with sources (DMA, Emarsys), comparison tables, bullet-point lists, pro tips, FAQ section with 40-60 word answers, and a clear CTA in the conclusion.
Content Type Templates
How-To Guide
Write a how-to guide for [task] targeting [keyword]
Comparison Article
Write a comparison article: [Option A] vs [Option B] for [keyword]
Listicle
Write a list post: "X Best [Items] for [Audience/Purpose]" targeting [keyword]
Ultimate Guide
Write an ultimate guide about [topic] (3,000+ words) targeting [keyword]
Tips for Success
- Match search intent - Informational queries need guides, not sales pages
- Front-load value - Put key information early for readers and snippets
- Use data and examples - Specific beats generic every time
- Write for humans first - SEO optimization should feel natural
- Include visual elements - Break up text with images, tables, lists
- Update regularly - Fresh content signals to search engines
Reference Materials
Related Skills
1---2name: seo-content-writer-33description: This skill should be used when the user asks to "write SEO content", "create a blog post", "write an article", "content writing for SEO", "draft optimized content", "write a how-to guide", "create a product description", "write a landing page", "SEO copywriting", "draft content targeting [keyword]", or "write 2000-word article about [topic]". Creates keyword-optimized content using a 12-step workflow: CORE-EEAT pre-write checklist, keyword integration, title optimization (5 formula options), meta description, H1/H2/H3 hierarchy, featured snippet targeting, internal/external linking, and readability enhancement. Produces full drafts with embedded SEO elements, title variants, meta description, FAQ section with schema, and a self-scored CORE-EEAT checklist. For AI-citation optimization, see geo-content-optimizer. For updating existing content, see content-refresher.4license: Apache-2.05---6
7# SEO Content Writer
8
9> **[SEO & GEO Skills Library](https://skills.sh/aaron-he-zhu/seo-geo-claude-skills)** · 20 skills for SEO + GEO · Install all: `npx skills add aaron-he-zhu/seo-geo-claude-skills`
10
11<details>
12<summary>Browse all 20 skills</summary>
13
14**Research** · [keyword-research](../../research/keyword-research/) · [competitor-analysis](../../research/competitor-analysis/) · [serp-analysis](../../research/serp-analysis/) · [content-gap-analysis](../../research/content-gap-analysis/)
15
16**Build** · **seo-content-writer** · [geo-content-optimizer](../geo-content-optimizer/) · [meta-tags-optimizer](../meta-tags-optimizer/) · [schema-markup-generator](../schema-markup-generator/)
17
18**Optimize** · [on-page-seo-auditor](../../optimize/on-page-seo-auditor/) · [technical-seo-checker](../../optimize/technical-seo-checker/) · [internal-linking-optimizer](../../optimize/internal-linking-optimizer/) · [content-refresher](../../optimize/content-refresher/)
19
20**Monitor** · [rank-tracker](../../monitor/rank-tracker/) · [backlink-analyzer](../../monitor/backlink-analyzer/) · [performance-reporter](../../monitor/performance-reporter/) · [alert-manager](../../monitor/alert-manager/)
21
22**Cross-cutting** · [content-quality-auditor](../../cross-cutting/content-quality-auditor/) · [domain-authority-auditor](../../cross-cutting/domain-authority-auditor/) · [entity-optimizer](../../cross-cutting/entity-optimizer/) · [memory-management](../../cross-cutting/memory-management/)
23
24</details>
25
26This skill creates search-engine-optimized content that ranks well while providing genuine value to readers. It applies proven SEO copywriting techniques, proper keyword integration, and optimal content structure.
27
28## When to Use This Skill
29
30- Writing blog posts targeting specific keywords
31- Creating landing pages optimized for search
32- Developing pillar content for topic clusters
33- Writing product descriptions for e-commerce
34- Creating service pages for local SEO
35- Producing how-to guides and tutorials
36- Writing comparison and review articles
37
38## What This Skill Does
39
401. **Keyword Integration**: Naturally incorporates target and related keywords
412. **Structure Optimization**: Creates scannable, well-organized content
423. **Title & Meta Creation**: Writes compelling, click-worthy titles
434. **Header Optimization**: Uses strategic H1-H6 hierarchy
445. **Internal Linking**: Suggests relevant internal link opportunities
456. **Readability Enhancement**: Ensures content is accessible and engaging
467. **Featured Snippet Optimization**: Formats for SERP feature opportunities
47
48## How to Use
49
50### Basic Content Creation
51
52```
53Write an SEO-optimized article about [topic] targeting the keyword [keyword]
54```
55
56```
57Create a blog post for [topic] with these keywords: [keyword list]
58```
59
60### With Specific Requirements
61
62```
63Write a 2,000-word guide about [topic] targeting [keyword],
64include FAQ section for featured snippets
65```
66
67### Content Briefs
68
69```
70Here's my content brief: [brief]. Write SEO-optimized content following this outline.
71```
72
73## Data Sources
74
75> See [CONNECTORS.md](../../CONNECTORS.md) for tool category placeholders.
76
77**With ~~SEO tool + ~~search console connected:**
78Automatically pull keyword metrics (search volume, difficulty, CPC), competitor content analysis (top-ranking pages, content length, common topics), SERP features (featured snippets, PAA questions), and keyword opportunities (related keywords, question-based queries).
79
80**With manual data only:**
81Ask the user to provide:
821. Target primary keyword and 3-5 secondary keywords
832. Target audience and search intent (informational/commercial/transactional)
843. Target word count and desired tone
854. Any competitor URLs or content examples to reference
86
87Proceed with the full workflow using provided data. Note in the output which metrics are from automated collection vs. user-provided data.
88
89## Instructions
90
91When a user requests SEO content:
92
931. **Gather Requirements**
94
95 Confirm or ask for:
96
97 ```markdown
98 ### Content Requirements
99
100 **Primary Keyword**: [main keyword]
101 **Secondary Keywords**: [2-5 related keywords]
102 **Target Word Count**: [length]
103 **Content Type**: [blog/guide/landing page/etc.]
104 **Target Audience**: [who is this for]
105 **Search Intent**: [informational/commercial/transactional]
106 **Tone**: [professional/casual/technical/friendly]
107 **CTA Goal**: [what action should readers take]
108 **Competitor URLs**: [top ranking content to beat]
109 ```
110
1112. **Load CORE-EEAT Quality Constraints**
112
113 Before writing, load content quality standards from the [CORE-EEAT Benchmark](../../references/core-eeat-benchmark.md):
114
115 ```markdown
116 ### CORE-EEAT Pre-Write Checklist
117
118 **Content Type**: [identified from requirements above]
119 **Loaded Constraints** (high-weight items for this content type):
120
121 Apply these standards while writing:
122
123 | ID | Standard | How to Apply |
124 |----|----------|-------------|
125 | C01 | Intent Alignment | Title promise must match content delivery |
126 | C02 | Direct Answer | Core answer in first 150 words |
127 | C06 | Audience Targeting | State "this article is for..." |
128 | C10 | Semantic Closure | Conclusion answers opening question + next steps |
129 | O01 | Heading Hierarchy | H1→H2→H3, no level skipping |
130 | O02 | Summary Box | Include TL;DR or Key Takeaways |
131 | O06 | Section Chunking | Each section single topic; paragraphs 3–5 sentences |
132 | O09 | Information Density | No filler; consistent terminology |
133 | R01 | Data Precision | ≥5 precise numbers with units |
134 | R02 | Citation Density | ≥1 external citation per 500 words |
135 | R04 | Evidence-Claim Mapping | Every claim backed by evidence |
136 | R07 | Entity Precision | Full names for people/orgs/products |
137 | C03 | Query Coverage | Cover ≥3 query variants (synonyms, long-tail) |
138 | O08 | Anchor Navigation | Table of contents with jump links |
139 | O10 | Multimedia Structure | Images/videos have captions and carry information |
140 | E07 | Practical Tools | Include downloadable templates, checklists, or calculators |
141
142 _These 16 items apply across all content types. For content-type-specific dimension weights, see the Content-Type Weight Table in [core-eeat-benchmark.md](../../references/core-eeat-benchmark.md)._
143 _Full 80-item benchmark: [references/core-eeat-benchmark.md](../../references/core-eeat-benchmark.md)_
144 _For complete content quality audit: use [content-quality-auditor](../../cross-cutting/content-quality-auditor/)_
145 ```
146
1473. **Research and Plan**
148
149 Before writing:
150
151 ```markdown
152 ### Content Research
153
154 **SERP Analysis**:
155 - Top results format: [what's ranking]
156 - Average word count: [X] words
157 - Common sections: [list]
158 - SERP features: [snippets, PAA, etc.]
159
160 **Keyword Map**:
161 - Primary: [keyword] - use in title, H1, intro, conclusion
162 - Secondary: [keywords] - use in H2s, body paragraphs
163 - LSI/Related: [terms] - sprinkle naturally throughout
164 - Questions: [PAA questions] - use as H2/H3s or FAQ
165
166 **Content Angle**:
167 [What unique perspective or value will this content provide?]
168 ```
169
1704. **Create Optimized Title**
171
172 ```markdown
173 ### Title Optimization
174
175 **Requirements**:
176 - Include primary keyword (preferably at start)
177 - Under 60 characters for full SERP display
178 - Compelling and click-worthy
179 - Match search intent
180
181 **Title Options**:
182
183 1. [Title option 1] ([X] chars)
184 - Keyword position: [front/middle]
185 - Power words: [list]
186
187 2. [Title option 2] ([X] chars)
188 - Keyword position: [front/middle]
189 - Power words: [list]
190
191 **Recommended**: [Best option with reasoning]
192 ```
193
1945. **Write Meta Description**
195
196 ```markdown
197 ### Meta Description
198
199 **Requirements**:
200 - 150-160 characters
201 - Include primary keyword naturally
202 - Include call-to-action
203 - Compelling and specific
204
205 **Meta Description**:
206 "[Description text]" ([X] characters)
207
208 **Elements included**:
209 - ✅ Primary keyword
210 - ✅ Value proposition
211 - ✅ CTA or curiosity hook
212 ```
213
2146. **Structure Content and Write**
215
216 Structure: H1 (primary keyword, one per page) > Introduction (100-150 words, hook + promise + keyword in first 100 words) > H2 sections (secondary keywords/questions) > H3 sub-topics > FAQ section > Conclusion (summary + keyword + CTA).
217
2187. **Apply On-Page SEO Best Practices**
219
220 Follow the on-page SEO checklist (keyword placement, content quality, readability, technical elements) and the content writing template (H1 with keyword, hook, sections with H2/H3, FAQ, conclusion with CTA).
221
222 > **Reference**: See [references/seo-writing-checklist.md](./references/seo-writing-checklist.md) for the full on-page SEO checklist, content writing template, and featured snippet optimization patterns.
223
224 Key requirements while writing:
225 - Primary keyword in title, H1, first 100 words, at least one H2, and conclusion
226 - Paragraphs of 3-5 sentences; varied sentence length; bullet points and bold key phrases
227 - Internal links (2-5) and external authoritative links (2-3)
228 - FAQ section with 40-60 word answers for featured snippet opportunity
229 - Optimize for definition, list, table, and how-to snippets where applicable
230
2318. **Add Internal/External Links**
232
233 ```markdown
234 ### Link Recommendations
235
236 **Internal Links** (include 2-5):
237 1. "[anchor text]" → [/your-page-url] (relevant because: [reason])
238 2. "[anchor text]" → [/your-page-url] (relevant because: [reason])
239
240 **External Links** (include 2-3 authoritative sources):
241 1. "[anchor text]" → [authoritative-source.com] (supports: [claim])
242 2. "[anchor text]" → [authoritative-source.com] (supports: [claim])
243 ```
244
2459. **Final SEO Review and CORE-EEAT Self-Check**
246
247 Score content across 10 SEO factors (title, meta description, H1, keyword placement, H2s, internal links, external links, FAQ, readability, word count) and produce an Overall SEO Score out of 10.
248
249 Then verify the 16 CORE-EEAT pre-write constraints (C01, C02, C06, C10, O01, O02, O06, O09, R01, R02, R04, R07, C03, O08, O10, E07) with pass/warning/fail status. List items needing attention.
250
251 _For full 80-item audit, use [content-quality-auditor](../../cross-cutting/content-quality-auditor/)_
252
253## Validation Checkpoints
254
255### Input Validation
256- [ ] Primary keyword confirmed and matches search intent
257- [ ] Target word count specified (minimum 800 words for substantive content)
258- [ ] Content type and audience clearly defined
259- [ ] Competitor URLs reviewed or target SERP features identified
260
261### Output Validation
262- [ ] Keyword density within 1-2% for primary keyword (Note: Keyword density is a guideline, not a hard rule. Modern search engines prioritize semantic relevance and natural language over exact density targets. Focus on covering the topic comprehensively with semantic variants rather than hitting a specific percentage.)
263- [ ] All sections from outline covered completely
264- [ ] Internal links included (2-5 relevant links)
265- [ ] FAQ section present with at least 3 questions
266- [ ] Readability score appropriate for target audience
267- [ ] Source of each data point clearly stated (~~SEO tool data, user-provided, or estimated)
268
269## Example
270
271**User**: "Write an SEO-optimized article about 'email marketing best practices' targeting small businesses"
272
273> **Reference**: See [references/seo-writing-checklist.md](./references/seo-writing-checklist.md) for the full example output demonstrating a complete SEO article with meta description, H1/H2/H3 hierarchy, statistics with citations, comparison tables, FAQ section, and conclusion with CTA.
274
275The example output demonstrates: keyword in H1 and first 100 words, statistics with sources (DMA, Emarsys), comparison tables, bullet-point lists, pro tips, FAQ section with 40-60 word answers, and a clear CTA in the conclusion.
276
277## Content Type Templates
278
279### How-To Guide
280
281```
282Write a how-to guide for [task] targeting [keyword]
283```
284
285### Comparison Article
286
287```
288Write a comparison article: [Option A] vs [Option B] for [keyword]
289```
290
291### Listicle
292
293```
294Write a list post: "X Best [Items] for [Audience/Purpose]" targeting [keyword]
295```
296
297### Ultimate Guide
298
299```
300Write an ultimate guide about [topic] (3,000+ words) targeting [keyword]
301```
302
303## Tips for Success
304
3051. **Match search intent** - Informational queries need guides, not sales pages
3062. **Front-load value** - Put key information early for readers and snippets
3073. **Use data and examples** - Specific beats generic every time
3084. **Write for humans first** - SEO optimization should feel natural
3095. **Include visual elements** - Break up text with images, tables, lists
3106. **Update regularly** - Fresh content signals to search engines
311
312## Reference Materials
313
314- [Title Formulas](./references/title-formulas.md) - Proven headline formulas, power words, CTR patterns
315- [Content Structure Templates](./references/content-structure-templates.md) - Templates for blog posts, comparisons, listicles, how-tos, pillar pages
316
317## Related Skills
318
319- [keyword-research](../../research/keyword-research/) — Find keywords to target
320- [geo-content-optimizer](../geo-content-optimizer/) — Optimize for AI citations
321- [meta-tags-optimizer](../meta-tags-optimizer/) — Create compelling meta tags
322- [on-page-seo-auditor](../../optimize/on-page-seo-auditor/) — Audit SEO elements
323- [content-quality-auditor](../../cross-cutting/content-quality-auditor/) — Full 80-item CORE-EEAT audit
324