SEO Content Writer
Creates SEO content that aligns with search intent, integrates keywords naturally, and stays usable for readers.
Quick Start
Write an SEO-optimized article about [topic] targeting the keyword [keyword]
Here's my content brief: [brief]. Write SEO-optimized content following this outline.
Skill Contract
Expected output: a ready-to-use draft plus the standard handoff summary 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 deliverable and reusable summary.
- Promotes: approved angles, messaging choices, missing evidence, and publish blockers to
memory/hot-cache.md and memory/open-loops.md; propose durable decisions as pending-decision items.
- Primary next skill: content-quality-auditor when the draft is ready for gating.
Handoff Summary
Emit the standard shape from skill-contract.md §Handoff Summary Format.
Data Sources
Use ~~SEO tool and ~~search console when connected; otherwise ask for keywords, intent, and competitors. See CONNECTORS.md.
Instructions
When a user requests SEO content, run these nine steps:
- Gather Requirements — confirm primary and secondary keywords, word count, content type, audience, intent, tone, CTA, and competitors.
- Load CORE-EEAT Constraints — apply the 16 high-weight items listed in the companion reference.
- Research and Plan — analyze the SERP, map keywords, and choose the content angle.
- Create Optimized Title — keep it concise, keyword-led, and aligned with intent.
- Write Meta Description — include the keyword, value proposition, and CTA.
- Structure Content and Write — use a clean H1 > intro > H2/H3 > FAQ > conclusion flow.
- Apply On-Page Best Practices — manage keyword placement, readability, snippets, and supporting visuals.
- Add Internal / External Links — include relevant internal and authoritative external links.
- Run Final SEO + CORE-EEAT Review — score the draft, auto-fix small issues, and surface any decisions that still need the user.
Reference: See references/instructions-detail.md for the compact workflow, pre-write checklist, issue-classification rules, and self-check format.
Example
Sample outcome: a keyword-led H1, optimized meta description, clear H2 structure, FAQ section, and a brief Changes Made block after the self-check. See references/seo-writing-checklist.md for the copy-start checklist and article template.
Content Type Templates
Quick-start patterns for how-to guides, comparisons, listicles, pillar pages, reviews, and FAQ pages live in references/content-structure-templates.md.
Tips for Success
Match intent, front-load value, support claims with evidence, and write for humans before optimizing for the SERP.
Save Results
On user confirmation, save memory/content/YYYY-MM-DD-<topic>.md and promote key conclusions to memory/hot-cache.md.
Reference Materials
Next Best Skill
1---2name: seo-content-writer-23description: Use when the user asks to "write SEO content"; drafts posts, articles, and landing pages with keywords, headers, snippets, and evidence boundaries. SEO文章写作/内容优化4license: Apache-2.05---6
7# SEO Content Writer
8
9Creates SEO content that aligns with search intent, integrates keywords naturally, and stays usable for readers.
10
11## Quick Start
12
13```
14Write an SEO-optimized article about [topic] targeting the keyword [keyword]
15```
16
17```
18Here's my content brief: [brief]. Write SEO-optimized content following this outline.
19```
20
21## Skill Contract
22
23**Expected output**: a ready-to-use draft plus the standard handoff summary for `memory/content/`.
24
25- **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.
26- **Writes**: a user-facing content deliverable and reusable summary.
27- **Promotes**: approved angles, messaging choices, missing evidence, and publish blockers to `memory/hot-cache.md` and `memory/open-loops.md`; propose durable decisions as pending-decision items.
28- **Primary next skill**: [content-quality-auditor](https://github.com/aaron-he-zhu/seo-geo-claude-skills/blob/main/cross-cutting/content-quality-auditor/SKILL.md) when the draft is ready for gating.
29
30### Handoff Summary
31
32> Emit the standard shape from [skill-contract.md §Handoff Summary Format](https://github.com/aaron-he-zhu/seo-geo-claude-skills/blob/main/references/skill-contract.md).
33
34## Data Sources
35
36Use `~~SEO tool` and `~~search console` when connected; otherwise ask for keywords, intent, and competitors. See [CONNECTORS.md](https://github.com/aaron-he-zhu/seo-geo-claude-skills/blob/main/CONNECTORS.md).
37
38## Instructions
39
40When a user requests SEO content, run these nine steps:
41
421. **Gather Requirements** — confirm primary and secondary keywords, word count, content type, audience, intent, tone, CTA, and competitors.
432. **Load CORE-EEAT Constraints** — apply the 16 high-weight items listed in the companion reference.
443. **Research and Plan** — analyze the SERP, map keywords, and choose the content angle.
454. **Create Optimized Title** — keep it concise, keyword-led, and aligned with intent.
465. **Write Meta Description** — include the keyword, value proposition, and CTA.
476. **Structure Content and Write** — use a clean H1 > intro > H2/H3 > FAQ > conclusion flow.
487. **Apply On-Page Best Practices** — manage keyword placement, readability, snippets, and supporting visuals.
498. **Add Internal / External Links** — include relevant internal and authoritative external links.
509. **Run Final SEO + CORE-EEAT Review** — score the draft, auto-fix small issues, and surface any decisions that still need the user.
51
52> **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 compact workflow, pre-write checklist, issue-classification rules, and self-check format.
53
54## Example
55
56Sample outcome: a keyword-led H1, optimized meta description, clear H2 structure, FAQ section, and a brief Changes Made block after the self-check. 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 copy-start checklist and article template.
57
58## Content Type Templates
59
60Quick-start patterns for how-to guides, comparisons, listicles, pillar pages, reviews, and FAQ pages live in [references/content-structure-templates.md](https://github.com/aaron-he-zhu/seo-geo-claude-skills/blob/main/build/seo-content-writer/references/content-structure-templates.md).
61
62## Tips for Success
63
64Match intent, front-load value, support claims with evidence, and write for humans before optimizing for the SERP.
65
66### Save Results
67
68On user confirmation, save `memory/content/YYYY-MM-DD-<topic>.md` and promote key conclusions to `memory/hot-cache.md`.
69
70## Reference Materials
71
72- [Instructions Detail](https://github.com/aaron-he-zhu/seo-geo-claude-skills/blob/main/build/seo-content-writer/references/instructions-detail.md) — Workflow, CORE-EEAT constraints, issue handling, self-check
73- [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 checklist, snippet patterns, and copy-start template
74- [Title Formulas](https://github.com/aaron-he-zhu/seo-geo-claude-skills/blob/main/build/seo-content-writer/references/title-formulas.md) — Headline formulas and CTR patterns
75- [Content Structure Templates](https://github.com/aaron-he-zhu/seo-geo-claude-skills/blob/main/build/seo-content-writer/references/content-structure-templates.md) — Compact content blueprints
76
77## Next Best Skill
78
79- **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.