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.
System role: Build layer skill. It turns briefs and signals into assets that other skills can review, publish, and monitor.
When This Must Trigger
Use this when the conversation involves a shippable asset or transformation that should feed directly into quality review, deployment, or monitoring — even if the user doesn't use SEO terminology:
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
Internal Linking: Suggests relevant internal link opportunities
Readability Enhancement: Ensures content is accessible and engaging
Featured Snippet Optimization: Formats for SERP feature opportunities
Quick Start
Start with one of these prompts. Finish with a short handoff summary using the repository format in Skill Contract.
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.
Skill Contract
Expected output: a ready-to-use asset or implementation-ready transformation plus a short handoff summary ready for memory/content/.
Reads: the brief, target keywords, entity inputs, quality constraints, and prior decisions from CLAUDE.md and the shared State Model when available.
Writes: a user-facing content, metadata, or schema deliverable plus a reusable summary that can be stored under memory/content/.
Promotes: approved angles, messaging choices, missing evidence, and publish blockers to memory/hot-cache.md, memory/decisions.md, and memory/open-loops.md.
Next handoff: use the Next Best Skill below when the asset is ready for review or deployment.
Research and Plan — SERP analysis, keyword map (primary/secondary/LSI/questions), content angle
Create Optimized Title — ≤60 chars, primary keyword front-loaded, power words
Write Meta Description — 150-160 chars, primary keyword, CTA
Structure Content and Write — H1 > intro (hook + promise + keyword in first 100 words) > H2 sections > H3 sub-topics > FAQ > conclusion
Apply On-Page SEO Best Practices — keyword placement, readability, internal/external links, FAQ section with 40-60 word answers, featured snippet formats
Final SEO Review and CORE-EEAT Self-Check — Score against 10 SEO factors and verify 16 CORE-EEAT constraints; classify issues (auto-correct vs. needs-decision)
Reference: See references/instructions-detail.md for the full step-by-step templates, CORE-EEAT constraint table, issue classification rules, and Changes Made block format.
Validation Checkpoints
Input Validation
Primary keyword confirmed and matches search intent
Target word count specified (minimum 800 words for substantive content)
Content type and audience clearly defined
Competitor URLs reviewed or target SERP features identified
Output Validation
Banned-vocab self-check — before finalizing, scan the draft for: crucial, robust, leverage, delve, nuanced, multifaceted, furthermore, moreover, pivotal, tapestry, foster, showcase, intricate, vibrant, cutting-edge, harness, elevate, empower, streamline, synergy, holistic, seamless, seamlessly, realm, paramount, myriad. Also banned phrases: In today's digital landscape, It is important to note, It's worth noting that, Let's dive in, Without further ado, At the end of the day. Replace any hit with a concrete alternative per skill-contract.md §Output Voice.
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.)
All sections from outline covered completely
Internal links included (2-5 relevant links)
FAQ section present with at least 3 questions
Readability score appropriate for target audience
Source of each data point clearly stated (~~SEO tool data, user-provided, or estimated)
Example
User: "Write an SEO-optimized article about 'email marketing best practices' targeting small businesses"
Output (abbreviated):
H1: Email Marketing Best Practices: A 2026 Guide for Small Businesses (keyword front-loaded; audience + year qualifier)
Meta description: Get 12 proven email marketing tactics that lift open rates 34% for small businesses. DMA-backed data, real subject-line examples, and a 30-day playbook. (~156 chars, CTA implied, stat hook)
Structure: H2 for each of 12 tactics, bullet lists, comparison table (Mailchimp vs Brevo vs ConvertKit), 6-question FAQ (40-60 word answers for featured snippets), CTA conclusion.
1---
2name: seo-content-writer
3description: 'Write SEO blog posts, articles, landing pages with keyword integration, header optimization, and snippet targeting. SEO文章写作/内容优化'
4version: "9.0.0"
5license: Apache-2.0
6compatibility: "Claude Code ≥1.0, skills.sh marketplace, ClawHub marketplace, Vercel Labs skills ecosystem. No system packages required. Optional: MCP network access for SEO tool integrations."
7homepage: "https://github.com/aaron-he-zhu/seo-geo-claude-skills"
8when_to_use: "Use when writing SEO-optimized articles, blog posts, landing pages, or product descriptions. Also when the user asks to create content targeting a specific keyword."
9argument-hint: "<topic> <target keyword>"
10metadata:
11 source: https://skillmd.com/skills/aaaaqwq/seo-content-writer
12 author: aaron-he-zhu
13 version: "9.0.0"
14 geo-relevance: "medium"
15 tags:
16 - seo
17 - content-writing
18 - blog-writing
19 - seo-copywriting
20 - content-creation
21 - featured-snippet-optimization
22 - article-writing
23 - landing-page
24 - surferSEO-alternative
25 - clearscope-alternative
26 - SEO文章
27 - 博客写作
28 - SEOライティング
29 - SEO글쓰기
30 - redaccion-seo
31 triggers:
32 # EN-formal
33 - "write SEO content"
34 - "create blog post"
35 - "write an article"
36 - "content writing"
37 - "draft optimized content"
38 - "write for SEO"
39 - "SEO copywriting"
40 - "blog writing"
41 # EN-casual
42 - "write me a blog post"
43 - "write me an article"
44 - "help me write about"
45 - "draft an article about"
46 - "I need a blog post"
47 - "create content for my site"
48 # EN-question
49 - "how do I write content that ranks"
50 - "how to write SEO friendly content"
51 - "what makes content rank well"
52 # EN-competitor
53 - "SurferSEO alternative"
54 - "Clearscope alternative"
55 - "Jasper AI alternative for SEO"
56 # ZH-pro
57 - "SEO文章写作"
58 - "SEO内容创作"
59 - "博客写作"
60 - "内容优化"
61 - "内容创作"
62 # ZH-casual
63 - "帮我写文章"
64 - "写一篇博客"
65 - "排名上不去"
66 - "帮我写SEO文章"
67 - "写一篇SEO文章"
68 # JA
69 - "SEOライティング"
70 - "SEO記事作成"
71 - "ブログ記事作成"
72 - "SEOコンテンツ"
73 # KO
74 - "SEO 글쓰기"
75 - "블로그 작성"
76 - "SEO 콘텐츠 작성"
77 - "블로그 글 작성해줘"
78 - "이 주제로 글 써봐"
79 # ES
80 - "redacción SEO"
81 - "escribir artículo SEO"
82 - "contenido optimizado"
83 # PT
84 - "redação SEO"
85 - "escrever artigo SEO"
86 # Misspellings
87 - "SEO copywritting"
88 - "writting SEO content"
89---
9091# SEO Content Writer
9293> **[SEO & GEO Skills Library](https://github.com/aaron-he-zhu/seo-geo-claude-skills)** · 20 skills for SEO + GEO · [ClawHub](https://clawhub.ai/u/aaron-he-zhu) · [skills.sh](https://skills.sh/aaron-he-zhu/seo-geo-claude-skills)
94> **System Mode**: This build skill follows the shared [Skill Contract](https://github.com/aaron-he-zhu/seo-geo-claude-skills/blob/main/references/skill-contract.md) and [State Model](https://github.com/aaron-he-zhu/seo-geo-claude-skills/blob/main/references/state-model.md).
959697This 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.
9899**System role**: Build layer skill. It turns briefs and signals into assets that other skills can review, publish, and monitor.
100101## When This Must Trigger
102103Use this when the conversation involves a shippable asset or transformation that should feed directly into quality review, deployment, or monitoring — even if the user doesn't use SEO terminology:
104105- Writing blog posts targeting specific keywords
106- Creating landing pages optimized for search
107- Developing pillar content for topic clusters
108- Writing product descriptions for e-commerce
109- Creating service pages for local SEO
110- Producing how-to guides and tutorials
111- Writing comparison and review articles
112113## What This Skill Does
1141151. **Keyword Integration**: Naturally incorporates target and related keywords
1162. **Structure Optimization**: Creates scannable, well-organized content
1173. **Title & Meta Creation**: Writes compelling, click-worthy titles
1184. **Header Optimization**: Uses strategic H1-H6 hierarchy
1195. **Internal Linking**: Suggests relevant internal link opportunities
1206. **Readability Enhancement**: Ensures content is accessible and engaging
1217. **Featured Snippet Optimization**: Formats for SERP feature opportunities
122123## Quick Start
124125Start with one of these prompts. Finish with a short handoff summary using the repository format in [Skill Contract](https://github.com/aaron-he-zhu/seo-geo-claude-skills/blob/main/references/skill-contract.md).
126127### Basic Content Creation
128129```
130Write an SEO-optimized article about [topic] targeting the keyword [keyword]
131```
132133```
134Create a blog post for [topic] with these keywords: [keyword list]
135```
136137### With Specific Requirements
138139```
140Write a 2,000-word guide about [topic] targeting [keyword],
141include FAQ section for featured snippets
142```
143144### Content Briefs
145146```
147Here's my content brief: [brief]. Write SEO-optimized content following this outline.
148```
149150## Skill Contract
151152**Expected output**: a ready-to-use asset or implementation-ready transformation plus a short handoff summary ready for `memory/content/`.
153154- **Reads**: the brief, target keywords, entity inputs, quality constraints, and prior decisions from [CLAUDE.md](https://github.com/aaron-he-zhu/seo-geo-claude-skills/blob/main/CLAUDE.md) and the shared [State Model](https://github.com/aaron-he-zhu/seo-geo-claude-skills/blob/main/references/state-model.md) when available.
155- **Writes**: a user-facing content, metadata, or schema deliverable plus a reusable summary that can be stored under `memory/content/`.
156- **Promotes**: approved angles, messaging choices, missing evidence, and publish blockers to `memory/hot-cache.md`, `memory/decisions.md`, and `memory/open-loops.md`.
157- **Next handoff**: use the `Next Best Skill` below when the asset is ready for review or deployment.
158159### Handoff Summary
160161Emit this shape when finishing the skill (see [skill-contract.md §Handoff Summary Format](https://github.com/aaron-he-zhu/seo-geo-claude-skills/blob/main/references/skill-contract.md) for the authoritative format):
162163- **Status**: DONE / DONE_WITH_CONCERNS / BLOCKED / NEEDS_INPUT
164- **Objective**: what was analyzed, created, or fixed
165- **Key Findings / Output**: the highest-signal result
166- **Evidence**: URLs, data points, or sections reviewed
167- **Open Loops**: blockers, missing inputs, or unresolved risks
168- **Recommended Next Skill**: one primary next move
169170## Data Sources
171172> See [CONNECTORS.md](https://github.com/aaron-he-zhu/seo-geo-claude-skills/blob/main/CONNECTORS.md) for tool category placeholders.
173174**With ~~SEO tool + ~~search console connected:**
175Automatically 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).
176177**With manual data only:**
178Ask the user to provide:
1791. Target primary keyword and 3-5 secondary keywords
1802. Target audience and search intent (informational/commercial/transactional)
1813. Target word count and desired tone
1824. Any competitor URLs or content examples to reference
183184Proceed with the full workflow using provided data. Note in the output which metrics are from automated collection vs. user-provided data.
185186## Instructions
187188When a user requests SEO content, run these nine steps in order:
1891901. **Gather Requirements** — primary/secondary keywords, word count, content type, audience, search intent, tone, CTA goal, competitor URLs
1912. **Load CORE-EEAT Quality Constraints** — 16 high-weight items (C01, C02, C06, C10, O01, O02, O06, O09, R01, R02, R04, R07, C03, O08, O10, E07)
1923. **Research and Plan** — SERP analysis, keyword map (primary/secondary/LSI/questions), content angle
1934. **Create Optimized Title** — ≤60 chars, primary keyword front-loaded, power words
1945. **Write Meta Description** — 150-160 chars, primary keyword, CTA
1956. **Structure Content and Write** — H1 > intro (hook + promise + keyword in first 100 words) > H2 sections > H3 sub-topics > FAQ > conclusion
1967. **Apply On-Page SEO Best Practices** — keyword placement, readability, internal/external links, FAQ section with 40-60 word answers, featured snippet formats
1978. **Add Internal/External Links** — 2-5 internal, 2-3 authoritative external
1989. **Final SEO Review and CORE-EEAT Self-Check** — Score against 10 SEO factors and verify 16 CORE-EEAT constraints; classify issues (auto-correct vs. needs-decision)
199200> **Reference**: See [references/instructions-detail.md](https://github.com/aaron-he-zhu/seo-geo-claude-skills/blob/main/build/seo-content-writer/references/instructions-detail.md) for the full step-by-step templates, CORE-EEAT constraint table, issue classification rules, and Changes Made block format.
201202## Validation Checkpoints
203204### Input Validation
205- [ ] Primary keyword confirmed and matches search intent
206- [ ] Target word count specified (minimum 800 words for substantive content)
207- [ ] Content type and audience clearly defined
208- [ ] Competitor URLs reviewed or target SERP features identified
209210### Output Validation
211- [ ] **Banned-vocab self-check** — before finalizing, scan the draft for: `crucial, robust, leverage, delve, nuanced, multifaceted, furthermore, moreover, pivotal, tapestry, foster, showcase, intricate, vibrant, cutting-edge, harness, elevate, empower, streamline, synergy, holistic, seamless, seamlessly, realm, paramount, myriad`. Also banned phrases: `In today's digital landscape`, `It is important to note`, `It's worth noting that`, `Let's dive in`, `Without further ado`, `At the end of the day`. Replace any hit with a concrete alternative per [skill-contract.md §Output Voice](https://github.com/aaron-he-zhu/seo-geo-claude-skills/blob/main/references/skill-contract.md).
212- [ ] 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.)
213- [ ] All sections from outline covered completely
214- [ ] Internal links included (2-5 relevant links)
215- [ ] FAQ section present with at least 3 questions
216- [ ] Readability score appropriate for target audience
217- [ ] Source of each data point clearly stated (~~SEO tool data, user-provided, or estimated)
218219## Example
220221**User**: "Write an SEO-optimized article about 'email marketing best practices' targeting small businesses"
222223**Output** (abbreviated):
224- H1: `Email Marketing Best Practices: A 2026 Guide for Small Businesses` (keyword front-loaded; audience + year qualifier)
225- Meta description: `Get 12 proven email marketing tactics that lift open rates 34% for small businesses. DMA-backed data, real subject-line examples, and a 30-day playbook.` (~156 chars, CTA implied, stat hook)
226- Structure: H2 for each of 12 tactics, bullet lists, comparison table (Mailchimp vs Brevo vs ConvertKit), 6-question FAQ (40-60 word answers for featured snippets), CTA conclusion.
227228> **Reference**: See [references/seo-writing-checklist.md](https://github.com/aaron-he-zhu/seo-geo-claude-skills/blob/main/build/seo-content-writer/references/seo-writing-checklist.md) for the full article with statistics citations, H1/H2/H3 hierarchy, and FAQ section.
229230## Content Type Templates
231232Quick-start prompts: How-to guide, Comparison article, Listicle, Ultimate guide. See [references/instructions-detail.md](https://github.com/aaron-he-zhu/seo-geo-claude-skills/blob/main/build/seo-content-writer/references/instructions-detail.md#content-type-templates) for all 4 templates.
233234## Tips for Success
235236Match intent, front-load value, use data, write for humans first, include visuals, update regularly. Full list in [references/instructions-detail.md](https://github.com/aaron-he-zhu/seo-geo-claude-skills/blob/main/build/seo-content-writer/references/instructions-detail.md#tips-for-success).
237238239### Save Results
240241After delivering content or optimization output to the user, ask:
242243> "Save these results for future sessions?"
244245If yes, write a dated summary to `memory/content/YYYY-MM-DD-<topic>.md` containing:
246- One-line description of what was created
247- Target keyword and content type
248- Open loops or items needing review
249- Source data references
250251**Gate check recommended**: Run content-quality-auditor before publishing (PostToolUse hook will remind automatically).
252253If any findings should influence ongoing strategy, recommend promoting key conclusions to `memory/hot-cache.md`.
254255## Reference Materials
256257- [Instructions Detail](https://github.com/aaron-he-zhu/seo-geo-claude-skills/blob/main/build/seo-content-writer/references/instructions-detail.md) - Full step-by-step workflow, CORE-EEAT constraints, issue classification, content type templates, tips
258- [SEO Writing Checklist](https://github.com/aaron-he-zhu/seo-geo-claude-skills/blob/main/build/seo-content-writer/references/seo-writing-checklist.md) - On-page SEO checklist, writing template, featured snippet patterns, full example
259- [Title Formulas](https://github.com/aaron-he-zhu/seo-geo-claude-skills/blob/main/build/seo-content-writer/references/title-formulas.md) - Proven headline formulas, power words, CTR patterns
260- [Content Structure Templates](https://github.com/aaron-he-zhu/seo-geo-claude-skills/blob/main/build/seo-content-writer/references/content-structure-templates.md) - Templates for blog posts, comparisons, listicles, how-tos, pillar pages
261262## Next Best Skill
263264- **Primary**: [content-quality-auditor](https://github.com/aaron-he-zhu/seo-geo-claude-skills/blob/main/cross-cutting/content-quality-auditor/SKILL.md) — gate the draft before publishing or handing it off.
Run npx get-skill add aaaaqwq/seo-content-writer in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.
Write SEO blog posts, articles, landing pages with keyword integration, header optimization, and snippet targeting. SEO文章写作/内容优化 It is listed under Marketing & Growth on SkillMD.
This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: makes network calls. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.
This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.
Yes. Installing skills from SkillMD is free. This skill is licensed under Apache-2.
aAAaqwq (@aaaaqwq) published this skill. Their other Agent Skills are listed on their SkillMD profile.