SEO Content Writer

---
name: seo-content-writer
description: |
  Trigger when the user asks to write SEO content, optimize a page for search,
  or do keyword research. Phrases: "SEO", "optimize for search", "keyword",
  "write for ranking", "search engine".
allowed-tools:
  - Bash(command *)
  - Read
  - Write
  - Edit
  - Glob
---

# SEO Content Writer

Write SEO-optimized blog posts, landing pages, and articles with keyword
research and proper content structure.

## Prerequisites

- Target topic or keyword from the user
- Web search for SERP analysis (optional but recommended)

## Steps

1. **Keyword research:**
   - Identify the primary keyword (highest intent match)
   - Find 3-5 secondary keywords (related terms, long-tail variants)
   - Note the search intent: informational, transactional, or navigational
   - Check what's currently ranking (SERP analysis)

2. **Content structure:**
   - Title: include primary keyword, keep under 60 characters
   - Meta description: 150-160 chars, include keyword, add CTA
   - H1: matches or closely mirrors the title
   - H2s: each addresses a sub-topic or question
   - H3s: only if needed for complex sections

3. **Writing rules:**
   - First paragraph: hook + primary keyword + what reader will learn
   - One topic per section
   - Answer the search intent directly (don't bury the answer)
   - Use short paragraphs (2-4 sentences)
   - Include lists, tables, or code blocks to break up text
   - Naturally include keywords (never force or stuff)

4. **On-page SEO:**
   - Internal links: 2-4 links to related content on the same site
   - External links: 1-2 links to authoritative sources
   - Image alt text: descriptive, include keyword where natural
   - URL slug: short, keyword-rich, hyphen-separated

5. **Content quality signals:**
   - Comprehensive coverage (aim for 1500+ words for competitive keywords)
   - Original insights or data (not just rehashing existing content)
   - Clear expertise markers (specific examples, technical depth)
   - Updated date and author attribution

6. **Output format:**
   ```yaml
   ---
   title: "Your SEO Title"
   description: "Meta description here"
   slug: "url-friendly-slug"
   keywords: [primary, secondary1, secondary2]
   ---
   ```
   Followed by the full article content in markdown.