Seo Content Writer

SEO Content Writer

Create SEO-optimized content with consistent brand voice across platforms.

Install

git clone https://github.com/thatrebeccarae/claude-marketing.git && cp -r claude-marketing/skills/seo-content-writer ~/.claude/skills/

Core Capabilities

Brand Voice Development

• Analyze existing content for voice characteristics
• Define personality archetypes and tone attributes
• Build voice consistency guidelines
• Create sample voice documents for team alignment

SEO Optimization

• Keyword research and natural integration
• Title tag and meta description optimization
• Header hierarchy (H1-H4) structure
• Internal linking strategy
• Content depth recommendations by type
• Readability scoring (Flesch-Kincaid, Gunning Fog)

Content Frameworks

• Blog posts: how-to, listicle, thought leadership, case study, comparison
• Social media: LinkedIn, Twitter/X, Instagram
• Email marketing: subject lines, preview text, body copy
• Landing pages: hero, features, social proof, CTA
• Product descriptions: benefit-driven, SEO-optimized

Workflow

1. Define Voice (if not established)

Ask the user for 3-5 examples of content they like. Analyze for:

• Tone (formal ↔ casual)
• Perspective (first person, second person, third person)
• Vocabulary level (technical ↔ accessible)
• Sentence structure (short/punchy ↔ flowing/complex)
• Personality traits (authoritative, friendly, provocative, empathetic)

2. Research Keywords

For SEO content:

• Identify primary keyword (1) and secondary keywords (3-5)
• Check search intent (informational, transactional, navigational)
• Note competing content and gaps
• Plan header structure around keyword clusters

3. Draft Content

Follow the appropriate framework from REFERENCE.md. Ensure:

• Primary keyword in title, H1, first 100 words, and meta description
• Secondary keywords distributed naturally through H2s and body
• Readability at appropriate level for the audience
• Clear CTA aligned with content goal

4. Optimize

• Check keyword density (1-2% for primary, <1% for secondary)
• Verify header hierarchy (single H1, logical H2/H3 nesting)
• Add internal links to related content
• Write meta title (50-60 chars) and meta description (150-160 chars)
• Verify readability score matches target audience

Content Type Guidelines

Key Principles

1. Write for humans first, search engines second. Natural language > keyword stuffing. 2. Match search intent. Informational queries need guides, not sales pages. 3. Front-load value. The first paragraph should answer the core question. 4. One CTA per piece. Do not dilute with multiple asks. 5. Scannable structure. Headers, bullets, bold key phrases. Most readers skim.

For detailed platform specs, SEO checklists, and content frameworks, see REFERENCE.md.

Brand Context (Optional)

If brand-profile.json exists in the working directory, read it before drafting content. Use the voice axes and descriptors to calibrate tone, the target audience to frame pain points and aspirations, and brand values to weave into messaging naturally. This profile is produced by the brand-dna skill.

SEO Content Writer — Examples

Example 1: Blog Post Creation

Prompt:

Write a how-to blog post targeting the keyword "shopify conversion rate optimization." Target audience is DTC brand owners who are technical enough to implement changes but not developers.

Expected output:

• Title: "How to Optimize Your Shopify Conversion Rate: 8 Proven Tactics"
• Meta description (155 chars) with primary keyword
• H1 matching title, H2s for each tactic with secondary keywords
• 1,800-2,200 words, Grade 8 readability
• Practical steps with specific Shopify settings/apps referenced
• FAQ section with 3-4 common questions
• CTA to download a conversion audit checklist

---

Example 2: Brand Voice Analysis

Prompt:

Analyze these 5 LinkedIn posts and define our brand voice. [posts provided]

Expected output:

• Voice personality: e.g., "Authoritative Practitioner — speaks from experience, not theory"
• Tone attributes: e.g., "Direct not aggressive, Opinionated not preachy, Data-backed not academic"
• Vocabulary analysis: technical level, preferred phrases, words to avoid
• Sentence structure patterns: average length, use of fragments, rhetorical questions
• Voice consistency score across the 5 samples
• Documented voice guide for team reference

---

Example 3: Social Media Optimization

Prompt:

Adapt this blog post into a LinkedIn post and a Twitter thread. The blog is about how most companies waste 30% of their Google Ads budget on irrelevant search terms.

Expected output:

LinkedIn (250 words):

• Hook: Bold stat in first line ("Most companies are burning 30% of their ad budget...")
• Body: 3 short paragraphs — the problem, why it happens, what to do
• CTA: "Drop 'audit' in the comments and I'll share our search term cleanup template"
• 3-4 relevant hashtags

Twitter thread (8 tweets):

• Tweet 1: Hook with the 30% stat (standalone value)
• Tweets 2-6: One tactic per tweet with specific example
• Tweet 7: Summary framework
• Tweet 8: CTA + "Follow for more paid media tips"

---

Example 4: SEO Content Audit

Prompt:

Audit this landing page for SEO. It targets "email marketing platform for ecommerce" but isn't ranking. [URL or content provided]

Expected output:

• On-page SEO score with specific findings:
• "Primary keyword missing from H1 — currently 'Welcome to Our Platform'"
• "Meta description is 210 chars (too long) and doesn't include target keyword"
• "No H2 headers — content is one long block"
• "Zero internal links"
• Readability analysis: current score + target
• Competitor comparison: what top 3 ranking pages do differently
• Prioritized fix list with estimated impact

SEO Content Writer — Reference

SEO Checklist

On-Page SEO

• [ ] Primary keyword in title tag (front-loaded)
• [ ] Primary keyword in H1 (only one H1 per page)
• [ ] Primary keyword in first 100 words
• [ ] Primary keyword in meta description
• [ ] Secondary keywords in H2 headings
• [ ] Keyword density: 1-2% primary, <1% each secondary
• [ ] Title tag: 50-60 characters
• [ ] Meta description: 150-160 characters
• [ ] URL slug contains primary keyword (lowercase, hyphens)
• [ ] At least 2 internal links to related content
• [ ] At least 1 external link to authoritative source
• [ ] Images have descriptive alt text with keywords where natural
• [ ] Header hierarchy is logical (H1 → H2 → H3, no skips)

Readability

• [ ] Paragraphs: 2-4 sentences max
• [ ] Sentences: 15-25 words average
• [ ] Flesch-Kincaid score matches target audience
• [ ] Active voice >80% of sentences
• [ ] Transition words used between sections
• [ ] Bold/italic used to highlight key phrases (not overused)
• [ ] Bullet lists for 3+ related items

Platform Specifications

LinkedIn

Structure:

[Hook — provocative statement or number]

[2-3 short paragraphs with the insight]

[Key takeaway or framework]

[CTA — question or invitation]

#hashtag1 #hashtag2 #hashtag3

Twitter/X

Thread structure:

Tweet 1: Hook (standalone value, makes people want more)
Tweet 2-N: One idea per tweet, each can stand alone
Last tweet: Summary + CTA + "Follow for more on [topic]"

Instagram

Email Marketing

Subject line formulas:

• Number + benefit: "5 Ways to Cut Ad Spend by 30%"
• Question: "Is Your Email List Costing You Revenue?"
• How-to: "How to Audit Your Shopify Store in 15 Minutes"
• Urgency + value: "Last Day: Free GA4 Audit Template"

Content Frameworks

Blog Post: How-To

Title: How to [Achieve Result] in [Timeframe/Steps]

H1: [Title with primary keyword]

Intro (100-150 words):
- Hook: Why this matters / what problem it solves
- Promise: What the reader will learn
- Credibility: Brief authority signal

H2: What Is [Topic]? (if needed for informational intent)
- Definition
- Why it matters

H2: Step 1: [Action Verb + Specific Task]
- Explanation
- Example or screenshot
- Pro tip or common mistake

H2: Step 2: [Action Verb + Specific Task]
...

H2: Common Mistakes to Avoid
- Mistake 1 + why it matters
- Mistake 2 + why it matters

H2: FAQ (optional, good for featured snippets)
- Q: [Common question in natural language]
- A: [Concise answer, 2-3 sentences]

Conclusion (50-100 words):
- Recap key steps
- CTA (download, subscribe, try the tool)

Blog Post: Listicle

Title: [Number] [Adjective] [Thing] for [Audience/Goal]

H1: [Title]

Intro: Why this list matters, what criteria were used

H2: 1. [Item Name]
- What it is
- Why it made the list
- Key stat or example

H2: 2. [Item Name]
...

H2: How to Choose the Right [Thing]
- Decision framework or comparison table

Conclusion + CTA

Blog Post: Thought Leadership

Title: [Contrarian Take or Bold Claim]

H1: [Title]

Intro: Set up the tension — conventional wisdom vs. your position

H2: The Current State of [Topic]
- What most people believe/do
- Data supporting the status quo

H2: Why [Conventional Wisdom] Is Wrong/Incomplete
- Your evidence
- Real-world examples

H2: A Better Approach
- Your framework or recommendation
- How to implement it

H2: What This Means for [Audience]
- Practical implications
- First steps

Conclusion: Restate the bold claim with evidence summary

Brand Voice Templates

Voice Definition Document

## Brand Voice

### Personality
[Archetype]: [2-3 sentence description]

### Tone Attributes
- **[Attribute 1]** not [opposite]: [example sentence]
- **[Attribute 2]** not [opposite]: [example sentence]
- **[Attribute 3]** not [opposite]: [example sentence]

### Vocabulary
- We say: [preferred terms]
- We avoid: [terms to avoid]
- Technical level: [accessible / moderate / expert]

### Writing Rules
1. [Rule about sentence length]
2. [Rule about tone shifts by context]
3. [Rule about jargon usage]

Performance Metrics

Content Metrics

Engagement Metrics

SEO Metrics