Get the FREE Ultimate OpenClaw Setup Guide →

generating-blog-outlines

npx machina-cli add skill WesleySmits/agent-skills/blog-outline-generator --openclaw
Files (1)
SKILL.md
7.9 KB

Blog Post Outline Generator

When to use this skill

  • User asks to outline a blog post
  • User has a topic and needs structure
  • User mentions SEO content planning
  • User wants competitive content analysis
  • User needs heading suggestions

Workflow

  • Clarify topic and target keyword
  • Research search intent
  • Analyze competitor structure
  • Generate outline with headings
  • Add keyword placement recommendations
  • Suggest content angles

Instructions

Step 1: Gather Input

Required information:

InputPurpose
Primary keywordMain search term to target
Topic/angleSpecific focus of the article
Target audienceWho the content is for
Content goalInform, convert, educate, entertain
Word count targetAffects depth and sections

Example prompt:

Topic: "How to optimize images for web performance"
Keyword: "image optimization"
Audience: Frontend developers
Goal: Educational tutorial
Length: 2,000 words

Step 2: Determine Search Intent

Intent TypeIndicatorsContent Style
Informational"how to", "what is", "guide"Tutorial, explainer
Commercial"best", "top", "vs", "review"Comparison, listicle
Transactional"buy", "pricing", "download"Product-focused, CTA-heavy
NavigationalBrand + featureDirect, feature-specific

Step 3: Competitor Analysis

Identify top-ranking content:

  • Check top 5 results for target keyword
  • Note common headings and sections
  • Identify content gaps to fill
  • Assess word count and depth

Analysis template:

## Competitor Analysis: [Keyword]

### Top 3 Ranking Articles

1. [Title] - [URL]
   - Word count: ~X,XXX
   - Key sections: [list]
   - Unique angle: [note]

2. [Title] - [URL]
   - Word count: ~X,XXX
   - Key sections: [list]
   - Unique angle: [note]

### Content Gaps Identified

- [ ] Missing topic: ...
- [ ] Outdated information: ...
- [ ] Better examples needed: ...

Step 4: Generate Outline Structure

Standard blog structure:

# [Title with Primary Keyword]

## Introduction (100-150 words)

- Hook: [attention-grabbing opener]
- Context: [why this matters now]
- Promise: [what reader will learn]
- Thesis: [main point/answer]

## [H2: First Main Section]

### [H3: Subsection if needed]

- Key point 1
- Key point 2
- Example or data point

### [H3: Another Subsection]

- Key point 1
- Supporting detail

## [H2: Second Main Section]

- Key points to cover
- Include [keyword variation] naturally

## [H2: Third Main Section]

### [H3: Practical subsection]

- Step-by-step if applicable
- Code examples if technical

## [H2: Common Mistakes / FAQ / Tips]

- Address related questions
- Add value beyond competitors

## Conclusion (100-150 words)

- Recap main points
- Actionable next step
- CTA (related content, newsletter, etc.)

Step 5: Keyword Placement Strategy

LocationPriorityGuideline
Title (H1)RequiredInclude primary keyword
First paragraphRequiredWithin first 100 words
H2 headingsHigh1-2 headings with keyword/variation
H3 headingsMediumNatural placement
Body textMedium1-2% density, variations
Meta descriptionRequiredInclude keyword near start
Image alt textMediumDescriptive with keyword if relevant
URL slugRequiredShort, keyword-focused

Keyword variations to include:

Primary: image optimization
Variations:

- optimize images
- image compression
- web image optimization
- compress images for web
- reduce image file size

Step 6: Content Angle Suggestions

Angle frameworks:

FrameworkDescriptionBest For
Ultimate GuideComprehensive, authoritativeHigh-competition keywords
Step-by-StepNumbered processHow-to queries
ListicleNumbered tips/tools"Best" or "Top" queries
ComparisonX vs Y analysisDecision-stage content
Case StudyReal example with resultsTrust-building content
Beginner's GuideFoundational, accessibleAwareness-stage content

Outline Templates

Tutorial/How-To:

# How to [Achieve Outcome]: [Benefit Statement]

## Introduction

- Problem statement
- What you'll learn

## Prerequisites / What You'll Need

## Step 1: [First Action]

## Step 2: [Second Action]

## Step 3: [Third Action]

## Troubleshooting Common Issues

## Next Steps / Advanced Tips

## Conclusion

Listicle:

# [Number] [Adjective] [Topic] for [Outcome] in [Year]

## Introduction

- Why this list matters
- How items were selected

## 1. [Item Name]

- Key benefit
- Best for: [use case]
- Consideration: [limitation]

## 2. [Item Name]

...

## How to Choose the Right [Topic]

## Conclusion

Comparison:

# [Option A] vs [Option B]: [Decision Framework]

## Introduction

- Why this comparison matters
- Quick verdict

## Overview Comparison Table

## [Option A] Explained

### Pros

### Cons

### Best For

## [Option B] Explained

### Pros

### Cons

### Best For

## Head-to-Head: [Criteria 1]

## Head-to-Head: [Criteria 2]

## Head-to-Head: [Criteria 3]

## Verdict: Which Should You Choose?

## Conclusion

Step 7: Finalize Outline

Checklist before delivering:

  • Title includes primary keyword
  • H2s cover main topic comprehensively
  • Logical flow from intro to conclusion
  • Content gaps from competitors addressed
  • Unique angle or value-add identified
  • Word count distributed across sections
  • CTA and next steps included

Section word count distribution (2,000 words):

Introduction: 150 words
Section 1: 400 words
Section 2: 400 words
Section 3: 400 words
Section 4: 350 words
Conclusion: 150 words
Buffer: 150 words

Output Format

# Blog Post Outline: [Title]

**Target Keyword:** [keyword]
**Word Count:** [target]
**Search Intent:** [type]
**Content Angle:** [framework]

---

## Outline

[Full outline with H2/H3 structure and bullet points for each section]

---

## Keyword Strategy

- Primary: [keyword]
- Variations: [list]
- Placement: [notes]

## Competitor Gaps Addressed

- [gap 1]
- [gap 2]

## Unique Value Proposition

[What makes this article stand out]

Validation

Before completing:

  • Primary keyword in title
  • 5-8 H2 sections for comprehensive coverage
  • Each section has clear purpose
  • Keyword variations distributed
  • Matches or exceeds competitor depth
  • Includes actionable elements

Error Handling

  • Vague topic: Ask for specific angle or target audience.
  • No keyword provided: Suggest keyword research or ask for target phrase.
  • Overly broad scope: Recommend splitting into series or narrowing focus.
  • Competing with own content: Check for cannibalization; suggest consolidation.

Resources

Source

git clone https://github.com/WesleySmits/agent-skills/blob/main/.agent/skills/blog-outline-generator/SKILL.mdView on GitHub

Overview

Generates structured blog post outlines based on a topic and primary keyword. It supports SEO content planning, organizes ideas before writing, and guides heading selection, angles, and keyword placement.

How This Skill Works

The tool gathers input (primary keyword, topic/angle, audience, goal, length), determines search intent, and analyzes competitors to identify content gaps. It then outputs a structured outline with headings and built-in keyword placement recommendations.

When to Use It

  • User asks to outline a blog post
  • User has a topic and needs a clear structure
  • Conducting SEO content planning and keyword strategy
  • Performing competitive content analysis to find gaps
  • Seeking heading suggestions and content angles

Quick Start

  1. Step 1: Gather Input — primary keyword, topic/angle, target audience, goal, and length
  2. Step 2: Determine Search Intent and analyze competitors for gaps
  3. Step 3: Generate Outline — create structured headings and embed keyword placement guidance

Best Practices

  • Clarify the topic and target keyword upfront
  • Research search intent before outlining
  • Analyze top competitors to identify gaps
  • Align outline with keyword placement strategy (title, intro, headings, body)
  • Include actionable angles and concrete examples

Example Use Cases

  • Outline for 'How to optimize images for web performance' with keyword 'image optimization'
  • Outline for 'A beginner’s guide to building a responsive design' with keyword 'responsive design'
  • Outline for 'Best practices for remote team communication' with keyword 'remote team communication'
  • Outline for 'Sustainable fashion basics for everyday wear' with keyword 'sustainable fashion'
  • Outline for 'Quick home workouts for busy professionals' with keyword 'home workouts'

Frequently Asked Questions

Add this skill to your agents
Sponsor this space

Reach thousands of developers