Back to list
WesleySmits

generating-blog-outlines

by WesleySmits

43 production-ready skills for AI coding agents. Works with Claude, GitHub Copilot, Cursor, Windsurf, and Zed.

0🍴 0📅 Jan 18, 2026

SKILL.md


name: generating-blog-outlines description: 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

Score

Total Score

60/100

Based on repository quality metrics

SKILL.md

SKILL.mdファイルが含まれている

+20
LICENSE

ライセンスが設定されている

0/10
説明文

100文字以上の説明がある

+10
人気

GitHub Stars 100以上

0/15
最近の活動

1ヶ月以内に更新

+10
フォーク

10回以上フォークされている

0/5
Issue管理

オープンIssueが50未満

+5
言語

プログラミング言語が設定されている

0/5
タグ

1つ以上のタグが設定されている

+5

Reviews

💬

Reviews coming soon