Skip to content

WesleySmits/agent-skills / .agent/skills/blog-outline-generator

generating-blog-outlines

Verified

Creates structured blog post outlines based on topics and keywords. Use when the user asks about blog structure, content outlines, SEO article planning, or wants to organize ideas before writing.

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

planning-and-task-breakdownaddyosmani/agent-skillsBreaks work into ordered tasks. Use when you have a spec or clear requirements and need to break work into implementable tasks. Use when a task feels too large to start, when you need to estimate scope, or when parallel work is possible.Stars: 119kUpdated Claude CodeCodexVerifiedInstall
screenpipethedotmack/claude-memSearch screen and audio history recorded by Screenpipe and optionally save selected context into claude-mem. Use when the user asks to recall desktop activity, a meeting, or something seen in another app through Screenpipe.Stars: 118kUpdated Claude CodeCodexVerifiedInstall
contact-widgetnexu-io/open-designSelf-contained floating chat widget with welcome screen, social links, meeting button, and message input. Single HTML file, zero dependencies.Stars: 108kUpdated Claude CodeCodexVerifiedInstall
meeting-notesnexu-io/open-designMeeting notes page — title bar with attendees, agenda checklist, decisions block, action items table with owners + dates, and a "next meeting" footer. Use when the brief mentions "meeting notes", "minutes", "1:1 notes", "all-hands recap", or "会议纪要".Stars: 108kUpdated Claude CodeCodexVerifiedInstall