blog-post-writer

# Blog Post Writer ## Overview This skill produces publishable technical blog posts that readers actually finish: a hook that earns the first scroll, a spine of clear sections, runnable examples, and a takeaway the reader can act on. Keywords: blog post, technical article, dev blog, tutorial, write-up, engineering blog, Medium, dev.to, Hashnode, announcement, essay, headline, hook, SEO. Use it for tutorials, deep dives, "how we built X" stories, opinion/architecture pieces, release announcements, and concept explainers. ## When To Use - "Write a blog post about <topic>." - "Turn these notes / this PR / this RFC into an article." - "I need a catchy intro and outline for a post on <topic>." - "Edit / tighten this draft." ## Process Follow these steps in order. Do not skip step 1 — most weak posts fail on audience and angle, not prose. 1. **Clarify the brief.** Establish (ask only if unknown): topic, target reader and their skill level, the single takeaway, desired length, tone, and platform. If the user gave a draft or notes, infer these and confirm the angle in one line. 2. **Find the angle.** Pick ONE controlling idea (the "so what"). Reject topics that are really 3 posts; split them. Write a one-sentence thesis you can defend. 3. **Outline.** Produce a section skeleton (H2s) before prose. Use `templates/outline.md`. Aim for 4-7 sections plus intro and conclusion. 4. **Write the hook.** Draft the opening using a pattern from `references/hooks.md`. The first two sentences...