Blog Writer

---
name: blog-writer
description: |
  Trigger when the user asks to write a blog post, article, or long-form
  content. Phrases: "write a blog post", "draft an article", "create content",
  "write about", "blog post on".
allowed-tools:
  - Bash(command *)
  - Read
  - Write
  - Edit
  - Glob
---

# Blog Writer

Write long-form blog posts from research to final draft with SEO
optimization and internal linking.

## Prerequisites

- Target topic or outline from the user
- Knowledge of the target blog/site structure (for internal links)

## Steps

1. **Research the topic:**
   - Identify key subtopics and questions to answer
   - Note any statistics, quotes, or data points to include
   - Understand the target audience's knowledge level

2. **Create an outline:**
   ```markdown
   # Title (include primary keyword)

   ## Introduction (hook + what they'll learn)
   ## [H2 Section 1] (address first key question)
   ### [H3 Subsection if needed]
   ## [H2 Section 2]
   ## [H2 Section 3]
   ## Conclusion (summary + CTA)
   ```

3. **Write the draft following these rules:**
   - Lead with value, not throat-clearing
   - One idea per paragraph
   - Use short sentences (aim for 15-20 words average)
   - Include code examples for technical posts
   - Add subheadings every 200-300 words
   - Use bullet points and numbered lists to break up walls of text

4. **SEO optimization:**
   - Primary keyword in title, first paragraph, and one H2
   - Meta description: 150-160 characters summarizing the post
   - Alt text for all images
   - Internal links to 2-3 related posts
   - External links to 1-2 authoritative sources

5. **Add frontmatter:**
   ```yaml
   ---
   title: "Your Title Here"
   description: "Meta description for search engines"
   date: YYYY-MM-DD
   tags: [tag1, tag2]
   ---
   ```

6. **Final review:**
   - Read aloud for flow
   - Check for jargon that needs explanation
   - Verify all links work
   - Ensure code examples are correct and runnable