Developer Blog Writer

---
name: blog-writer
description: Transform brain dumps into polished technical blog posts. Use when you have scattered ideas, talking points, or code examples that need organizing into a cohesive developer-focused post.
---

# Developer Blog Writer

Transform unstructured thoughts into polished technical blog posts.

## Reference Files

Load these before writing:

| File | Purpose |
|------|---------|
| `references/voice-tone.md` | Writing voice and style guide |
| `references/story-circle.md` | Narrative framework for posts |
| `references/post-templates.md` | Starter structures by post type |
| `references/seo-checklist.md` | Pre-publish SEO checks |

## Process

### 1. Receive the Brain Dump

Accept whatever is provided:
- Scattered thoughts and ideas
- Technical points to cover
- Code snippets or commands
- Conclusions or takeaways

Don't require organization. The mess is the input.

### 2. Load Voice Guide

Read `references/voice-tone.md` for writing style:
- Professional-casual tone
- First-person, inclusive language ("we", "us")
- Show the journey, not just the destination

### 3. Identify Post Type

| Type | Use When |
|------|----------|
| Tutorial | Step-by-step instructions |
| Project Showcase | Sharing what you built |
| Opinion | Your take on a topic |
| TIL | Quick, focused insight |
| Comparison | X vs Y analysis |

### 4. Check for Story Potential

Read `references/story-circle.md` and look for:
- Journey from confusion to clarity
- Problem you solved
- Something learned the hard way
- Perspective shift

### 5. Organize & Write

**Opening:** Hook with problem, question, or motivation. No "In this post, I will..."

**Body:**
- Vary paragraph length
- Include specific details
- Show actual code
- Be honest about what didn't work

**Ending:**
- Tie back to opening
- Actionable takeaway
- Forward-looking ("Stay tuned for...")

### 6. Review & Optimize

**Voice check:**
- Does it sound like a developer talking to peers?
- Is there a clear thread from start to finish?

**SEO check** (from `references/seo-checklist.md`):
- [ ] Primary keyword in title and first paragraph
- [ ] Meta description (150-160 chars)
- [ ] URL slug is short and clean
- [ ] 2-3 internal/external links
- [ ] Code blocks specify language

## Quick Voice Reference

### Do:
- Write like explaining to a smart colleague
- Admit uncertainty or mistakes
- Use specific examples with real details
- Show what you tried, not just what worked

### Don't:
- Use corporate or marketing speak
- Over-explain basic concepts
- Start with "In this post..." or "As we all know..."
- Force humor or excessive emojis