seo-content-writer

name	seo-content-writer
description	SEO-optimized content creation with brand voice analysis and platform-specific frameworks. Covers blog posts, social media, email marketing, and landing pages. Includes keyword integration, readability optimization, and performance metrics.
license	MIT
origin	custom
author	Rebecca Rae Barton
author_url	https://github.com/thatrebeccarae
metadata	{"version":"1.0.0","category":"seo","domain":"seo","updated":"2026-03-13T00:00:00.000Z","tested":"2026-03-17T00:00:00.000Z","tested_with":"Claude Code v2.1"}

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

Type	Target Length	Readability	Keywords
Blog (how-to)	1,500-2,500 words	Grade 7-9	1 primary + 3-5 secondary
Blog (thought leadership)	800-1,500 words	Grade 9-12	1-2 keywords, lighter touch
LinkedIn post	150-300 words	Conversational	0-1 hashtag-keywords
Twitter thread	5-12 tweets	Punchy, scannable	Topic-relevant, not forced
Email body	100-200 words	Grade 6-8	None (engagement-focused)
Landing page	500-1,000 words	Grade 6-8	1 primary + 2-3 secondary
Product description	150-300 words	Grade 7-9	1 primary + 1-2 secondary

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.