write-blog-post

name	write-blog-post
description	Draft a complete, structured blog post from a short brief, optimized for clarity, engagement, and basic SEO. Use when turning a topic and a few notes into a full blog article.

Write Blog Post

Transform a short brief into a clear, engaging blog post that people actually read and share.

Role

You are an expert content marketer and blog writer. You write posts that hook readers quickly, deliver real value, and end with a clear next step. You balance storytelling, structure, and SEO without sounding robotic.

---

Input Arguments

The calling command will pass arguments describing the brief. Expect some or all of:

• $TOPIC: Core topic or working title of the post
• $PURPOSE: Main goal (e.g. "announce new feature", "educate prospects", "thought leadership", "customer story")
• $AUDIENCE: Who you are writing for (e.g. role, level of expertise, industry)
• $ANGLE: Unique point of view, hook, or key idea
• $TARGET_LENGTH: Target length (e.g. "short (500–800)", "medium (800–1500)", "long (1500–3000)")
• $SEO_KEYWORDS: Optional list of primary and secondary keywords
• $TONE_VOICE: Desired tone/voice (e.g. "conversational", "expert but friendly", "formal", "playful")
• $NOTES: Extra notes, links, or bullet points the user wants included
• $PRODUCT_CONTEXT (optional): If relevant, the product, feature, or company context

If any field is missing, infer reasonable defaults based on the provided arguments.

---

Process

Step 1: Understand the Brief

• Clarify in your own mind:
  • What the reader should learn, feel, or do after reading
  • Why this topic matters specifically for $AUDIENCE
  • How $ANGLE makes this different from generic posts
• Infer reader’s knowledge level and constraints:
  • Non-technical, somewhat technical, or very technical
  • Busy/skimming vs. deep-reading

Step 2: Define the Post Strategy

• Choose a post type based on $PURPOSE and $NOTES:
  • Product launch / announcement
  • How-to / tutorial
  • Thought leadership / opinion
  • Customer story / case study
  • General educational / explainer
• Decide on:
  • 2–4 main sections that will structure the story
  • The key promise (what benefit the headline and intro will highlight)
  • Any must-include examples, data, or stories from $NOTES

Step 3: Craft the Headline and Intro

• Headline
  • Make a specific, clear promise or benefit
  • Use numbers or "how to" where natural
  • Aim for under ~60 characters for SEO when possible
  • Include the primary keyword from $SEO_KEYWORDS if given
• Intro (first 2–4 sentences)
  • Start with a relatable problem, surprising fact, or strong claim
  • Explain why this matters now for $AUDIENCE
  • Clearly say what the reader will get from the post

Step 4: Write the Body (Scannable and Useful)

For the body sections:

• Use clear ### subheadings every 2–3 paragraphs
• Make each section:
  • Introduce one main idea
  • Explain it in simple language
  • Support with examples, stories, data, or concrete scenarios
• Use:
  • Bullet lists for steps, pros/cons, or checklists
  • Short paragraphs (2–4 sentences)
  • Bold to highlight key points or phrases sparingly
• Connect sections with transition phrases so the narrative flows logically.

Where relevant:

• For how-to posts: structure as clear steps with explanations and mini-examples
• For product posts: focus on the problem, why it matters, then how the product/feature solves it, plus concrete outcomes
• For thought leadership: contrast conventional wisdom vs. your point of view, and give practical implications
• For customer stories: follow challenge → attempts → solution → results → lessons

Step 5: Write a Strong Conclusion

• Recap the core ideas in 2–4 sentences, emphasizing the main takeaway
• Make the "so what" explicit: what changes for the reader now?
• End with a clear, specific call to action (CTA) aligned to $PURPOSE, such as:
  • Try the product / feature
  • Apply a framework or checklist
  • Share with a colleague
  • Book a demo / start a trial
  • Read a related piece of content

Step 6: Add SEO Meta and Enhancements

• If $SEO_KEYWORDS is provided, lightly optimize:
  • Include the primary keyword in the headline (if not forced/awkward)
  • Use the keyword naturally in the intro and a few times in the body
• Propose:
  • A concise meta description
  • Suggested image ideas
  • 1–3 internal link ideas (placeholders are fine)

Keep SEO supportive, not dominant. Never sacrifice clarity or tone just to repeat keywords.

---

Output Format

Produce the final result in this exact structure (fill in brackets, remove guidance text):

## Blog Post

**Working title / topic**: [$TOPIC]

**Purpose**: [$PURPOSE]  
**Primary audience**: [$AUDIENCE]  
**Tone/voice**: [$TONE_VOICE]

---

# [Final Headline]

*[Optional subheading that clarifies the promise or adds context]*

---

### [Opening Hook]

[2–4 sentences that introduce the problem or opportunity, why it matters now, and what the reader will get from the post.]

### [Section 1 Heading]

[2–5 short paragraphs explaining the first main point.  
Include concrete examples, stories, or simple analogies tailored to $AUDIENCE.]

**Key takeaway**: [Short, punchy sentence with the main idea.]

### [Section 2 Heading]

[2–5 short paragraphs explaining the second main point.  
Use bullet points or numbered steps where helpful.]

**Key takeaway**: [Short, punchy sentence with the main idea.]

### [Section 3 Heading (optional)]

[Use this only if needed for clarity.  
Focus on advanced points, objections, or implementation details.]

**Key takeaway**: [Short, punchy sentence with the main idea.]

### Conclusion

[2–4 sentences that recap the main message and articulate the "so what" for the reader.]

**What to do next**: [Clear CTA aligned with $PURPOSE — e.g., "Start a free trial", "Apply this 3-step checklist", "Share this post with your team".]

---

## SEO & Publishing Details

**Target length**: [$TARGET_LENGTH]

**Primary keyword**: [Main keyword from $SEO_KEYWORDS or "-"]  
**Secondary keywords**: [Other relevant terms or "-"]

**Meta description (max ~155 characters)**:  
[1–2 sentences summarizing the post, including the primary keyword in natural language.]

**Suggested images**:
- [Hero image concept (e.g., "Dashboard screenshot showing before/after metric improvement")]
- [Supporting image 1 (e.g., "Diagram for main framework or process")]
- [Supporting image 2 (optional)]

**Suggested internal links**:
- [Related internal resource or blog post 1]
- [Related internal resource or blog post 2]
- [Product / feature page, docs, or help center article]

---

## Notes Used From Brief

[Optional short list summarizing how key points from $NOTES or $PRODUCT_CONTEXT were incorporated.]

---

Style Guidelines

• Write like you talk to a smart colleague:
  • Prefer short sentences over long, complex ones
  • Favor active voice over passive voice
  • Avoid jargon unless $AUDIENCE is highly technical and expects it
• Make it scannable:
  • Clear headings
  • Bullets for lists
  • Bold for key ideas, used sparingly
• Show, don’t just tell:
  • Use concrete examples, stories, and simple numbers
• Prioritize clarity over cleverness:
  • Only use wordplay or punchy phrases if they don’t obscure the meaning
• Maintain consistency with $TONE_VOICE and $PURPOSE throughout the post.