Seo Content Writer

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, and quality constraints.
• 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.
• Done when: the draft satisfies the target intent with the primary keyword placed naturally; H1/H2 structure, meta description, and at least one snippet-targetable block are present; and every claim needing a source is either cited or flagged.
• 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:

1. Gather Requirements — confirm primary and secondary keywords, word count, content type, audience, intent, tone, CTA, and competitors. 2. Load CORE-EEAT Constraints — apply the 16 high-weight items listed in the companion reference. 3. Research and Plan — analyze the SERP, map keywords, and choose the content angle. 4. Create Optimized Title — keep it concise, keyword-led, and aligned with intent. 5. Write Meta Description — include the keyword, value proposition, and CTA. 6. Structure Content and Write — use a clean H1 > intro > H2/H3 > FAQ > conclusion flow. 7. Apply On-Page Best Practices — manage keyword placement, readability, snippets, and supporting visuals. 8. Add Internal / External Links — include relevant internal and authoritative external links. 9. Run Final SEO + CORE-EEAT Review — score the draft, auto-fix small issues, and surface any decisions that still need the user.

Any factual claim, statistic, or quote that requires a source must be cited or explicitly flagged [needs source]; never invent figures, studies, dates, or attributions to fill a gap.

Quality bar: before handing off, confirm the draft passes — (1) intent match: a reader with the target query gets their answer above the fold; (2) keyword placement reads naturally (no stuffing) in title, H1, first 100 words, and one H2; (3) structure is scannable (H2/H3, lists, one snippet-ready block); (4) zero fabricated facts — every source-needing claim is cited or [needs source]. If any item fails, fix it or report it in the handoff, do not ship silently.

Reference: See Instructions Detail 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 to memory/content/YYYY-MM-DD-<topic>.md — see Skill Contract §Save Results Template.

Reference Materials

• Instructions Detail — Workflow, CORE-EEAT constraints, issue handling, self-check
• SEO Writing Checklist — On-page checklist, snippet patterns, and copy-start template
• Title Formulas — Headline formulas and CTR patterns
• Content Structure Templates — Compact content blueprints

Next Best Skill

• Primary: content-quality-auditor — gate the draft before publishing.

Content Structure Templates

Compact blueprints for common SEO formats. Replace placeholders, keep the primary keyword in the H1 and first 100 words, and remove sections that do not match intent.

Shared Build Rules

Blueprint Matrix

Copy-Start Matrix

Section Blocks

Implementation Checklist

• [ ] Replace placeholders and remove irrelevant sections.
• [ ] Put the primary keyword in H1 and first 100 words.
• [ ] Use secondary keywords naturally in H2/H3s.
• [ ] Add proof, examples, source/date citations, or data.
• [ ] Include FAQ and definition blocks when useful for GEO retrieval.
• [ ] Add internal/external links and descriptive image alt text.
• [ ] Include affiliate disclosure when applicable.
• [ ] Finish with meta title and description matching the final angle.

SEO Content Writer — Detailed Instructions

Compact workflow, pre-write checklist, issue handling, and content-type quick starts for the SEO Content Writer skill.

1. Gather Requirements

### 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 this is for]
**Search Intent**: [informational/commercial/transactional]
**Tone**: [professional/casual/technical/friendly]
**CTA Goal**: [desired action]
**Competitor URLs**: [top ranking pages to beat]

2. Load CORE-EEAT Constraints

Apply these 16 high-weight items while writing:

3. Research and Plan

Map:

• SERP format and average depth
• Primary, secondary, related, and question keywords
• Unique angle or differentiator

4. Create Optimized Title

Provide 2-3 title options, each with length, keyword position, and why it works.

5. Write Meta Description

Deliver one recommended description with keyword, value proposition, and CTA.

6. Structure Content and Write

Use:

• H1
• Introduction with hook, promise, and keyword early
• H2 sections matching search intent
• H3 sub-topics where needed
• FAQ section for snippet opportunities
• Conclusion with recap + CTA

7. Apply On-Page SEO Best Practices

Key checks:

• Primary keyword in title, H1, intro, at least one H2, and conclusion
• 3-5 sentence paragraphs
• Bullet points, tables, and bolding where they improve scan-ability
• 2-5 internal links and 2-3 authoritative external links
• FAQ answers in 40-60 words when snippet-friendly

8. Add Internal and External Links

### Link Recommendations

**Internal Links**
1. "[anchor text]" → [/your-page-url] — [reason]

**External Links**
1. "[anchor text]" → [authoritative-source.com] — supports [claim]

9. Final SEO Review and CORE-EEAT Self-Check

Score the draft across 10 SEO factors:

• Title
• Meta description
• H1
• Keyword placement
• H2 coverage
• Internal links
• External links
• FAQ
• Readability
• Word-count fit

Then verify the 16 CORE-EEAT items above with Pass / Warn / Fail.

Issue Classification

Auto-correct and document in ### Changes Made:

• Overlong title or meta description
• Missing alt text
• Duplicate H2s
• Excessive keyword repetition
• Missing TOC on long pages
• Paragraphs that need splitting

### Changes Made During Self-Check

| Item | Original | Fixed |
|------|----------|-------|
| Meta description | 185 chars | 158 chars — removed extra qualifier |

Ask the user before changing:

• H1 wording
• Tone
• Major length changes
• Strong claims that need moderation
• External links or stats that cannot be verified

Content Type Templates

• How-To Guide: Write a how-to guide for [task] targeting [keyword]
• Comparison Article: Write [Option A] vs [Option B] for [keyword]
• Listicle: Write "X Best [Items] for [Audience]" targeting [keyword]
• Ultimate Guide: Write an ultimate guide about [topic] targeting [keyword]

Tips for Success

Match intent, front-load value, use evidence, write for humans first, and refresh high-value content regularly.

SEO Writing Checklist and Content Template

Compact checklist for drafting SEO content that is useful, scannable, and ready for a CORE-EEAT review.

On-Page Checklist

Copy-Start Template

# [H1 with Primary Keyword]

**Meta Description**: [150-160 char value proposition with keyword and CTA]

[Hook] [Problem statement] [Promise: what the reader will learn] [Primary keyword naturally]

## [H2 with Secondary Keyword]
[1-2 sentence setup]
[Useful explanation with evidence, examples, or data]

### [H3 if needed]
- [Actionable point]
- [Actionable point]
- [Actionable point]

## [H2 for next major section]
> **Pro Tip**: [Specific, non-obvious implementation note]

| Comparison point | Option A | Option B |
|------------------|----------|----------|
| [Factor] | [Evidence] | [Evidence] |

## Frequently Asked Questions

### [Question from PAA or common query]?
[Direct 40-60 word answer that can stand alone as a snippet.]

## Conclusion
[Summarize key points, restate the primary keyword naturally, and give one clear CTA.]

**Sources**: [Source name + URL + access date], [Source name + URL + access date]

Snippet Patterns

Example Calibration Card

Use this instead of copying a full sample article:

Final Self-Check

• [ ] The draft answers the dominant search intent before selling.
• [ ] Every claim that depends on data has a named source and date.
• [ ] Internal links support the topic journey, not just link volume.
• [ ] Headings form a useful outline when read alone.
• [ ] FAQ answers are direct enough for featured snippets.
• [ ] The conclusion gives one clear next action.

Title and Headline Formulas

Use these copy-start patterns to write titles that match intent, earn clicks, and stay within SERP display limits. Default target: 50-60 characters; mobile-heavy pages should aim for 50-55 characters.

Formula Matrix

CTR Modifiers

Avoid all caps, excessive punctuation, unsupported superlatives, vague clickbait, and promises the content does not fulfill.

Length Guidelines

Rewrite Examples

Title QA

• [ ] Primary keyword appears naturally.
• [ ] Search intent and content format match the SERP.
• [ ] Title is specific, truthful, and concrete.
• [ ] Length fits the target surface.
• [ ] Modifier adds real value, not clickbait.
• [ ] Mobile truncation still leaves the main promise clear.
• [ ] Title is meaningfully different from top competitors.