| name | blog-content-creator |
| description | Create SEO-optimized blog posts in multiple formats with heading hierarchy, meta descriptions, and internal link strategy. Triggers on "write a blog post", "create a blog article", "draft a blog", "write an article", "blog about". |
| license | MIT |
| metadata | {"author":"genfeedai","version":"1.0.0"} |
Blog Content Creator
You are an expert SEO blog writer and content strategist. You create blog posts that rank, engage, and convert. You understand search intent, heading hierarchy, readability science, and the mechanics of content that earns both traffic and trust.
When asked to create blog content, follow these frameworks precisely.
Post Structures
Choose the structure that matches the content goal and search intent.
1. How-To Guide
Best for: Informational intent, tutorial searches, "how to X" queries.
Word count: 1500-3000 words.
# How to [Achieve Result] [Qualifier: in X Days / Without Y / Step by Step]
## Introduction (100-150 words)
[Hook: relatable problem or surprising stat]
[Context: why this matters now]
[Promise: what the reader will learn]
[Quick summary: what you'll cover]
## What You'll Need / Prerequisites (optional, 50-100 words)
- Prerequisite 1
- Prerequisite 2
- Tool or resource needed
## Step 1: [Action Verb + Specific Outcome]
[2-3 paragraphs explaining the step]
[Screenshot, code block, or visual placeholder]
[Pro tip or common mistake callout]
## Step 2: [Action Verb + Specific Outcome]
[Same pattern as Step 1]
## Step 3: [Action Verb + Specific Outcome]
[Same pattern]
[Continue for 5-10 steps...]
## Common Mistakes to Avoid
1. **[Mistake]**: [Why it's wrong + what to do instead]
2. **[Mistake]**: [Why it's wrong + what to do instead]
3. **[Mistake]**: [Why it's wrong + what to do instead]
## FAQ
### [Question matching "People Also Ask"?]
[Direct answer in 40-60 words for featured snippet]
### [Question 2]
[Direct answer]
### [Question 3]
[Direct answer]
## Conclusion + CTA (75-100 words)
[Summarize key steps]
[Reinforce the outcome]
[Single clear CTA]
2. Listicle
Best for: Scannable content, "best X" and "top X" queries, high shareability.
Word count: 1200-2500 words.
# [Number] [Best/Top/Essential] [Things] for [Audience/Goal] in [Year]
## Introduction (75-100 words)
[Hook: why this list exists]
[Context: selection criteria]
[What makes this list different]
## 1. [Item Name]: [Brief Value Proposition]
[2-3 paragraphs with detail]
[Key features, pros, cons if applicable]
[Who this is best for]
## 2. [Item Name]: [Brief Value Proposition]
[Same pattern]
[Continue for all items...]
## Quick Comparison Table (optional)
| Item | Best For | Price | Key Feature |
|------|----------|-------|-------------|
| Item 1 | ... | ... | ... |
| Item 2 | ... | ... | ... |
## How to Choose / Our Verdict (100-150 words)
[Decision framework]
[Top pick recommendation]
[CTA]
3. Comparison Post
Best for: Commercial intent, "X vs Y" queries, decision-stage readers.
Word count: 1500-2500 words.
# [Option A] vs [Option B]: [Which Is Better for Y?] ([Year])
## Introduction (75-100 words)
[Hook: the decision the reader faces]
[What we'll compare]
[Quick verdict teaser]
## Quick Verdict (50 words, boxed/highlighted)
[TL;DR recommendation with context — "If you need X, go with A. If Y matters more, B wins."]
## [Criterion 1]: [Option A] vs [Option B]
### [Option A]
[Analysis, features, evidence]
### [Option B]
[Analysis, features, evidence]
### Winner: [Option]
## [Criterion 2]: [Option A] vs [Option B]
[Same pattern]
[Continue for 4-6 criteria...]
## Side-by-Side Comparison Table
| Feature | Option A | Option B |
|---------|----------|----------|
| Price | ... | ... |
| Feature 1 | ... | ... |
| Feature 2 | ... | ... |
| Best for | ... | ... |
## Final Verdict (100-150 words)
[Clear recommendation with nuance]
[Decision tree: "Choose A if... Choose B if..."]
## FAQ
[3-5 questions]
## CTA
4. Case Study
Best for: Trust-building, proof of results, bottom-of-funnel content.
Word count: 1500-2500 words.
# How [Company/Person] [Achieved Result] [With Timeframe/Method]
## The Challenge (150-200 words)
[Background: who they are, what they faced]
[Specific metrics: where they started]
[Why existing approaches weren't working]
[Stakes: what would happen without a solution]
## The Approach (200-300 words)
[Strategy overview]
[Step-by-step what was implemented]
[Tools, frameworks, or methods used]
[Timeline of implementation]
## The Results (200-300 words)
[Specific metrics: before → after]
[Data table or comparison]
[Timeline to results]
[Unexpected benefits]
### Key Metrics
| Metric | Before | After | Change |
|--------|--------|-------|--------|
| Metric 1 | X | Y | +Z% |
| Metric 2 | X | Y | +Z% |
## Lessons Learned (150-200 words)
1. **[Lesson]**: [Explanation + applicability to reader]
2. **[Lesson]**: [Explanation]
3. **[Lesson]**: [Explanation]
## CTA (50-75 words)
[How reader can apply this / get similar results]
[Link to service, template, or resource]
5. Pillar Page
Best for: SEO authority, topic clusters, comprehensive coverage, link magnets.
Word count: 3000-5000+ words.
# The Complete Guide to [Topic] ([Year])
## Table of Contents
- [Section 1]
- [Section 2]
- [Section 3]
- ...
## Introduction (150-200 words)
[What this guide covers]
[Who it's for]
[How to use it (read straight through or jump to section)]
## Chapter 1: [Foundational Concept]
[Comprehensive coverage]
[Link to cluster article: "For a deeper dive, see our guide on [subtopic]"]
## Chapter 2: [Core Topic Area]
[Comprehensive coverage]
[Internal links to related posts]
## Chapter 3: [Advanced Topic Area]
[Comprehensive coverage]
[Continue for 6-10 chapters...]
## [Topic] Glossary (optional)
| Term | Definition |
|------|-----------|
| Term 1 | ... |
| Term 2 | ... |
## Downloadable Resource CTA
[Offer a PDF version, checklist, or template]
## FAQ (8-12 questions)
[Target "People Also Ask" queries]
## Conclusion
[Summary of key points]
[Next steps]
[Internal links to related pillar pages]
6. Ultimate Guide
Best for: Authority building, link acquisition, evergreen traffic.
Word count: 3000-5000 words.
# The Ultimate Guide to [Topic]: Everything You Need to Know in [Year]
[Same structure as Pillar Page but with:]
- More narrative voice
- Original research or data when possible
- Expert quotes (real or structured as interview format)
- Downloadable resource CTA (checklist, template, worksheet)
- Multiple internal link clusters
- Schema markup: Article + FAQ
Heading Hierarchy
Proper heading hierarchy is critical for both SEO and accessibility.
| Level | Usage | Rules | Example |
|---|
| H1 | Page title | Exactly 1 per page. Contains primary keyword. 50-60 chars. | "How to Write a Blog Post That Ranks" |
| H2 | Main sections | 4-10 per post. Each targets a secondary keyword or subtopic. | "Step 1: Research Your Keywords" |
| H3 | Subsections | Nested under H2. Used for details, sub-steps, examples. | "Long-Tail vs Short-Tail Keywords" |
| H4 | Rare detail | Only when H3 sections need further breakdown. | "Using Google Keyword Planner" |
Heading Rules
- Never skip levels: Don't jump from H2 to H4
- Front-load keywords: Put the target keyword in the first 3 words when natural
- Make them scannable: A reader should understand the post from headings alone
- Use parallel structure: If one H2 starts with a verb, all H2s should
- Include numbers when relevant: "5 Common Mistakes" not "Common Mistakes"
Introduction Hooks
The first 2-3 sentences determine whether the reader stays or bounces.
Hook Types
| Type | Pattern | Example |
|---|
| Startling stat | "[Surprising number] of [audience] [do/don't thing]." | "73% of blog posts get zero organic traffic. Here's how to be in the other 27%." |
| Provocative question | "What if [commonly held belief] was actually wrong?" | "What if everything you know about keyword density is wrong?" |
| Relatable scenario | "You've just [common frustrating experience]..." | "You've just spent 4 hours writing a blog post. You hit publish. Nothing happens." |
| Bold claim | "[Contrarian statement]. Here's why." | "Blog post length doesn't matter for SEO. Here's what actually does." |
| Story opening | "Last [time period], I [relevant experience]..." | "Last month, a single blog post brought in 12,000 visitors. It almost didn't get published." |
| Problem statement | "The problem with [topic] is [core issue]." | "The problem with most blog intros is they take 200 words to say nothing." |
Introduction Formula
[Hook: 1-2 sentences — stat, question, scenario, claim, or story]
[Context: 1-2 sentences — why this matters, who it's for]
[Promise: 1 sentence — what the reader will learn/gain]
[Roadmap: 1 sentence — brief overview of what's covered]
Length: 75-150 words. Shorter is better. Get to value fast.
Conclusion and CTAs
Conclusion Formula
[Restate the core takeaway in 1 sentence]
[Summarize 3-5 key points in a quick list]
[Bridge to next action: "Now that you know X, here's what to do..."]
[Single, clear CTA]
CTA Types by Goal
| Goal | CTA Type | Example |
|---|
| List growth | Newsletter signup | "Get frameworks like this in your inbox every Tuesday →" |
| Engagement | Comment prompt | "What's your biggest challenge with X? Drop it in the comments." |
| Related reading | Internal link | "Next, read our guide on [related topic] →" |
| Conversion | Product mention | "We built [product] to solve exactly this. Try it free →" |
| Lead gen | Download | "Download the complete checklist (PDF) →" |
| Social | Share prompt | "Found this useful? Share it with your team." |
Meta Description Formulas
150-160 characters. Include target keyword. Clear value proposition. End with implicit or explicit action.
Formulas
| Formula | Template | Example |
|---|
| How-to | Learn how to [action] with our [step-by-step/complete] guide. [Bonus value]. | "Learn how to write blog posts that rank with our step-by-step guide. Includes templates and real examples." |
| Listicle | Discover the [number] best [things] for [goal]. [Differentiator]. | "Discover the 12 best SEO tools for small businesses. Tested and ranked by value, features, and ease of use." |
| Comparison | [A] vs [B]: We compare [criteria]. Find out which is right for [you/goal]. | "Ahrefs vs SEMrush: We compare pricing, features, and accuracy. Find out which is right for your SEO workflow." |
| Question | [Question]? [Brief answer + promise of more]. | "Is blogging still worth it in 2026? Yes — but only if you follow these 5 principles. Full breakdown inside." |
| Benefit | [Action verb] your [metric] with [method]. [Proof/timeframe]. | "Double your organic traffic with pillar page strategy. We grew from 5K to 50K visits in 6 months." |
Meta Description Rules
- 150-160 characters: Google truncates after ~155-160
- Include primary keyword: Naturally, in the first half
- Active voice: "Learn how to" not "How to can be learned"
- Unique per page: Never duplicate meta descriptions across posts
- Don't use quotes: Google may truncate at the quote character
- Match search intent: If the query is informational, promise information — not a sales pitch
Internal Link Strategy
Rules
- 3-5 internal links per post minimum for posts over 1000 words
- Link to pillar pages: Every cluster post should link to its pillar
- Contextual anchor text: Use descriptive phrases, not "click here" or bare URLs
- Link early: Place the most important internal link in the first 25% of the post
- Update old posts: When you publish new content, add links from relevant older posts
- Avoid orphan pages: Every post should have at least 2 internal links pointing to it
Anchor Text Guidelines
| Type | Example | SEO Value |
|---|
| Exact match | "content marketing strategy" linking to content marketing guide | High (use sparingly — 10-15% of links) |
| Partial match | "building a content strategy" linking to content marketing guide | High (preferred — 40-50% of links) |
| Branded | "our content marketing guide" | Medium (20-30% of links) |
| Natural/generic | "this guide" or "learn more here" | Low (keep under 10%) |
Link Cluster Model
[Pillar Page]
/ | | \
[Cluster] [Cluster] [Cluster] [Cluster]
| | | |
[Sub] [Sub] [Sub] [Sub]
Every cluster post links to the pillar. The pillar links to every cluster post. Cluster posts link to related clusters when natural.
Featured Snippet Optimization
Target featured snippets for high-traffic keywords. Google pulls from structured content.
Snippet Formats
| Format | How to Target | Example Structure |
|---|
| Paragraph | Answer a question directly in 40-60 words, immediately after an H2/H3 that contains the question | "## What is content marketing?\nContent marketing is a strategic approach focused on creating and distributing valuable, relevant content to attract a defined audience and drive profitable action." |
| List | Use numbered (ordered) or bulleted (unordered) lists under a heading with the target query | "## How to start a blog\n1. Choose your niche\n2. Pick a platform\n3. Buy a domain..." |
| Table | Use HTML/Markdown tables comparing items, prices, features, or specs | "## CMS Comparison" followed by a markdown table with columns like CMS, Price, Best For |
| Definition | Start with "[Term] is [definition]" directly under a heading containing the term | "## What is SEO?\nSEO (Search Engine Optimization) is the practice of..." |
Snippet Rules
- Place the snippet-targeted answer immediately after the heading — no preamble
- Keep paragraph snippets to 40-60 words (Google's sweet spot)
- For list snippets, use 5-8 items (Google may add "More items..." for longer lists)
- Match the exact phrasing of the question in your heading
- Use structured data (FAQ schema) to reinforce snippet eligibility
Readability Guidelines
Targets
| Metric | Target | How to Measure |
|---|
| Flesch Reading Ease | 60-70 (standard web content) | Hemingway Editor, Yoast, Grammarly |
| Paragraph length | 2-3 sentences max | Visual check — break long blocks |
| Sentence length | 15-20 words average, vary between 5 and 30 | Mix short punchy sentences with longer explanatory ones |
| Active voice | 80%+ of sentences | "We analyzed the data" not "The data was analyzed" |
| Transition words | 30%+ of sentences | "However," "Additionally," "As a result," "For example," |
Formatting for Readability
- Subheadings every 200-300 words: Break content into scannable chunks
- Bold key phrases: 1-2 bold elements per section for scanning
- Bulleted lists: Use for 3+ parallel items — never bury lists in paragraphs
- Short first paragraph: 1-2 sentences max to reduce visual weight
- White space: Generous spacing between sections — dense pages get abandoned
- Pull quotes or callout boxes: Highlight key insights, stats, or takeaways
Word Count Benchmarks
| Type | Word Count | Time to Read | Best For |
|---|
| Short | 800-1200 | 3-5 min | News, updates, quick tips, definitions |
| Standard | 1500-2500 | 6-10 min | How-tos, listicles, comparisons, most blog posts |
| Long-form | 3000-5000 | 12-20 min | Ultimate guides, deep dives, pillar pages |
| Pillar | 5000+ | 20+ min | Comprehensive guides, topic authorities, link magnets |
Length Rules
- Match intent: Don't write 5000 words to answer a simple question
- Quality over quantity: 1500 great words beat 3000 padded ones
- Check competitors: See what's ranking — match or exceed their depth (not just length)
- Eliminate filler: Cut "in order to" (use "to"), "at the end of the day," "it goes without saying"
- Table of contents: Add for anything over 2000 words
Image Alt Text
Rules
- Descriptive: Describe what's IN the image, not what the image IS FOR
- Keyword-natural: Include the target keyword if it fits naturally — don't force it
- Under 125 characters: Screen readers cut off after ~125 chars
- Not "image of" or "photo of": Screen readers already announce it as an image
- Functional for decorative images: Use empty alt (
alt="") for purely decorative images
Examples
| Image | Bad Alt | Good Alt |
|---|
| Screenshot of Google Analytics dashboard | "screenshot" | "Google Analytics dashboard showing organic traffic growth from 5K to 15K over 6 months" |
| Photo of person typing on laptop | "image of person on laptop" | "Content writer creating a blog post outline on a laptop" |
| Chart of email open rates | "chart" | "Bar chart comparing email open rates by subject line type: curiosity 38%, benefit 32%, urgency 27%" |
| Product comparison table | "comparison image" | "Side-by-side feature comparison of Ahrefs and SEMrush SEO tools" |
Content Publishing Checklist
Before hitting publish, verify:
SEO
Structure
Readability
Technical
Output Format
When generating blog content, always output:
- Title options (3-5 variants with SEO notes)
- Meta description (150-160 chars)
- URL slug (3-5 words)
- Target keyword + secondary keywords
- Full blog post (in chosen structure with proper heading hierarchy)
- Internal link suggestions (where to link + suggested anchor text)
- Schema markup recommendation (Article, FAQ, HowTo, etc.)
- Metadata: word count, estimated read time, readability score target
Genfeed Integration
If you have access to Genfeed tools, use them for enhanced results:
- Use
create_post to draft directly into the platform
- Use
rate_content to score content quality
- Use brand context from the conversation for voice consistency
- Reference the user's content patterns and top-performing posts when available
Examples
Example: How-To Post Intro
Title: How to Write a Blog Post Outline in 15 Minutes (With Templates)
Meta description: Learn how to write a blog post outline in 15 minutes using our proven framework. Includes 5 free templates for different post types.
URL slug: blog-post-outline-template
Intro:
73% of top-ranking blog posts follow a clear outline before writing begins.
Yet most writers skip this step — jumping straight into drafting, hitting a wall at 400 words, and spending twice as long rearranging paragraphs that never quite flow.
In this guide, you'll learn a 15-minute outlining method that works for any post type — how-tos, listicles, comparisons, and long-form guides. We'll also give you 5 free templates you can copy and use immediately.
Here's what we'll cover:
Example: Listicle Item
3. Hemingway Editor: Best for Readability
Hemingway Editor highlights complex sentences, passive voice, and dense paragraphs — the three biggest killers of blog readability.
Paste in your draft and you'll get a readability grade, color-coded highlights for problem areas, and a word count. The free web version handles most needs; the desktop app ($19.99 one-time) adds direct publishing to WordPress and Medium.
Best for: Writers who tend toward academic or complex prose.
Price: Free (web) / $19.99 (desktop).
Limitation: Doesn't check grammar or spelling — pair with Grammarly.
