Blog Post

Research, draft, and polish publication-ready blog posts.

Workflow

Blog post progress:
- [ ] Step 1: Clarify topic and format
- [ ] Step 2: Research and gather sources
- [ ] Step 3: Extract key insights and outline
- [ ] Step 4: Write the post
- [ ] Step 5: SEO and polish
- [ ] Step 6: Validate quality

Step 1: Clarify topic and format

Determine the post type before writing. Ask the user if unclear:

Step 2: Research and gather sources

Read files, fetch URLs, or accept pasted text. If the user provides a topic without sources, research the topic before writing. Read every source completely before outlining.

Accept messy input — scattered thoughts, bullet points, brain dumps, random observations. The mess is the input; structure is the output.

Step 3: Extract key insights and outline

• Identify the most surprising, counter-intuitive, or impactful takeaways.
• Rank insights by reader value — lead with the strongest.
• Select 2-4 powerful quotes for blockquotes (only the best).
• Find a relatable problem or curiosity gap to anchor the introduction.
• Check for narrative potential: is there a journey from one understanding to another?

Create a section outline before drafting. Each section should have a clear purpose.

Step 4: Write the post

Choose the matching format template below.

Listicle template

# [Compelling Headline with Specific Promise]

[Hook: 1-2 sentences — relatable problem or surprising fact]

[Bridge: why this matters now]

[Promise: what the reader will take away]

## [Takeaway 1: Bold Insight Statement]

[2-4 sentence explanation. Analyze why this is interesting, don't just summarize.]

> "[Powerful quote from source]" — [Attribution]

[What this means for the reader.]

## [Takeaway 2: Bold Insight Statement]

[Continue for each insight]

## Looking Ahead

[The bigger picture, 1-2 sentences]

[Thought-provoking closing question]

Tutorial / how-to template

# [How to Achieve Specific Outcome]

[Hook: the problem this solves, 1-2 sentences]

[Who this is for and what they'll be able to do after reading]

## What You Need

[Prerequisites, tools, or context — keep brief]

## Step 1: [Action Verb + Outcome]

[Explain what and why, 2-3 sentences]

[Code example, command, or screenshot if applicable]

## Step 2: [Action Verb + Outcome]

[Continue for each step]

## Common Pitfalls

[2-3 mistakes to avoid, with fixes]

## What's Next

[Where to go from here — next steps, related topics, or CTA]

Narrative template

# [Headline That Hints at the Journey]

[Opening scene or moment — specific, concrete, grounded in experience]

[Tension: what was uncomfortable, uncertain, or challenging]

## [The Shift]

[What changed — the discovery, realization, or turning point]

[Specific details: tool names, commands, real examples]

## [What I Learned]

[Lessons with enough context for the reader to apply them]

## [Where This Goes]

[Forward-looking close — tie back to the opening]

Thought leadership template

# [Thesis Statement as Headline]

[Hook: conventional wisdom or common belief to challenge]

[Your thesis in one clear sentence]

## [Evidence Point 1]

[Argument with supporting data, examples, or quotes]

## [Evidence Point 2]

[Continue for each supporting point]

## What This Means

[Implications for the reader's work or thinking]

[CTA or call to reflection]

Step 5: SEO and polish

• Title: under 60 characters, include the main keyword.
• Meta description: 150-160 characters summarizing the post's value.
• Keyword placement: naturally in the title, first paragraph, and 2-4 times throughout.
• Headers: descriptive H2/H3 tags that work as standalone scan points.
• Internal links: suggest 2-3 related links if the user has other content.

Step 6: Validate quality

Before finalizing, verify:
- [ ] Hook grabs attention in the first 1-2 sentences
- [ ] Headline is specific and delivers on its promise
- [ ] Every paragraph is 2-4 sentences maximum
- [ ] Each section has analysis or insight, not just summary
- [ ] Blockquotes are limited to 2-4 total
- [ ] Conclusion looks forward with a question, CTA, or provocative takeaway
- [ ] Tone is conversational throughout — no academic language
- [ ] Title is under 60 characters with the main keyword
- [ ] Post includes a meta description (150-160 chars)
- [ ] Markdown renders correctly (headings, blockquotes, bold, code)

Blog-specific voice

• Write to a smart friend, not a committee. Authenticity beats authority.
• Bold key phrases for scannability — readers skim before they read.
• Show, don't tell: specific examples with real details beat vague claims.
• Admit uncertainty when genuine. Never bluff expertise.

Headline patterns

• Number + insight: "7 Things [Sources] Reveal About [Topic]"
• Surprising tension: "Why [Common Belief] Gets [Topic] Wrong"
• How-to framing: "How to [Achieve Outcome] with [Method]"
• Question format: "What If [Provocative Reframe]?"

Under 60 characters for SEO. Sentence case, no trailing period. Must deliver on its promise.

Anti-patterns

• Generic headlines ("Interesting Findings About X").
• Conclusions that just summarize what was already said.
• Clickbait headlines the content does not deliver on.
• Blockquoting every source instead of choosing the 2-4 most powerful.
• Skipping research and writing from assumptions.

Skill handoffs