
Blog Outline
- 1.7k installs
- 1.6k repo stars
- Updated July 23, 2026
- agricidaniel/claude-blog
blog-outline is a content-planning skill that turns an approved brief into a SERP-informed article skeleton with H2/H3 headings, word-count targets, FAQ slots, and internal-link zones for developers publishing technical
About
blog-outline is a Claude blog skill that converts an approved brief into a structured article skeleton before full drafting begins. It performs SERP-informed outline generation with H2 and H3 heading hierarchy, competitive content-gap cues, section-by-section word-count targets, chart and image placement markers, FAQ question planning, and internal linking zones. blog-outline is intentionally lighter than blog-brief, which covers full competitive analysis, statistics research, and image suggestions; blog-outline delivers structure only, ready for a /blog write step to consume. Developers reach for blog-outline when prompts mention outline, blog outline, content outline, article skeleton, or heading structure. Use blog-outline after a brief is approved and before prose drafting when you need an SEO-shaped scaffold with explicit section budgets rather than a complete research brief.
- Hierarchical heading structure
- Section-level key points
- Narrative flow validation
- Brief-to-outline conversion
- Pre-draft structural review
Blog Outline by the numbers
- 1,691 all-time installs (skills.sh)
- +43 installs in the week ending Aug 5, 2026 (Skillselion tracking)
- Ranked #197 of 1,879 Documentation skills by installs in the Skillselion catalog
- Data as of Aug 5, 2026 (Skillselion catalog sync)
npx skills add https://github.com/agricidaniel/claude-blog --skill blog-outlineAdd your badge
Show developers this skill is listed on Skillselion. Paste this into your README.
| Installs | 1.7k |
|---|---|
| repo stars | ★ 1.6k |
| Last updated | July 23, 2026 |
| Repository | agricidaniel/claude-blog ↗ |
How do you structure an SEO blog outline from a brief?
Turn an approved brief into a sectioned outline with headings, key points, and flow before full drafting begins.
Who is it for?
Developers and technical writers with an approved blog brief who need a SERP-shaped outline skeleton before running a full draft pass.
Skip if: Teams that still need competitive statistics research, image sourcing, or a complete content brief—use blog-brief instead of blog-outline for that heavier research stage.
When should I use this skill?
The user says outline, blog outline, content outline, structure blog, plan sections, article skeleton, or heading structure after a brief is ready.
What you get
Sectioned article skeleton with H2/H3 hierarchy, word-count targets, FAQ question slots, chart or image markers, and internal linking zones.
- H2/H3 article skeleton
- Section word-count plan
- FAQ and internal-link map
Files
Blog Outline Generator: SERP-Informed Structure Planning
Generates skeletal blog post outlines informed by SERP analysis. A lighter alternative to a full content brief - produces heading hierarchy, section targets, and content gap notes without deep statistics research or full competitive analysis.
Cross-reference
For evidence-led topical-relevance and content-planning prompts upstream of outlining, see /blog flow find. The blog-post-outline-prompt under /blog flow optimize is a complementary structural reference.
Workflow
Step 1: Topic & Intent
Gather from the user: 1. Topic or target keyword (required) 2. Target keyword - the exact phrase to rank for (if different from topic) 3. Search intent - Informational, commercial, or transactional
If only a topic is given, infer the keyword and intent from context.
Step 2: SERP Analysis
Use WebSearch to analyze the top 5 results for the target keyword:
1. Search for the target keyword 2. For each of the top 5 results, note:
- Heading structure - H2/H3 topics covered
- Content length - Approximate word count
- Visual elements - Charts, images, videos, infographics
- FAQs - Any FAQ sections or People Also Ask coverage
- Unique angles - What makes each result distinct
- Gaps - What's missing or weak
3. Use WebFetch on the top 2-3 results to extract detailed heading structures if the search snippets are insufficient.
4. Compile a summary of common patterns and missed opportunities.
Step 3: Generate Outline
Create a structured outline with the following format:
# Outline: [Topic]
## Title Suggestions
1. [Primary title - 40-60 chars, front-loaded keyword, power word]
2. [Alternative title - different angle]
3. [Alternative title - question format]
## Target Parameters
- **Primary keyword**: [keyword]
- **Search intent**: [Informational/Commercial/Transactional]
- **Target word count**: [X,XXX] words
- **H2 sections**: [6-8]
- **Target reading level**: Flesch 60-70
---
## Outline
### H2: [Section Title - Question Format] (~300-400 words)
- **Answer-first opener**: [What stat or fact should open this section?]
- **Key points to cover**:
- [Point 1]
- [Point 2]
- [Point 3]
- **H3: [Subsection]** (if appropriate)
- [What this subsection covers]
- **Key statistic to find**: [What data point would strengthen this section?]
- **Chart suggestion**: [Bar/Line/Donut/None] - [What data to visualize]
- **Image placement**: [Yes/No] - [Description of recommended image]
### H2: [Section Title] (~300-400 words)
[... repeat for 6-8 sections ...]
### FAQ Section (3-5 items)
1. [Question from People Also Ask] - [Brief answer direction]
2. [Question from People Also Ask] - [Brief answer direction]
3. [Question from People Also Ask] - [Brief answer direction]
4. [Question from SERP analysis] - [Brief answer direction]
### Conclusion (~100-150 words)
- Key takeaways to summarize
- Call to action direction
---
## Internal Linking Zones
- **Link TO from this post**: [Existing content that should be referenced]
- **Link FROM to this post**: [Existing content that should link here]
## Content Gaps to Exploit
1. [What competitors miss that this post should cover]
2. [Unique angle or original perspective to include]
3. [Format advantage - visuals, depth, or structure competitors lack]Guidelines for heading generation:
- 60-70% of H2 headings should be in question format
- Each H2 should have a clear answer-first paragraph prompt
- Include H3 subsections only where the topic genuinely warrants subdivision
- Target word counts should sum to the overall post target
- Chart type suggestions should be diverse (no two identical types)
- Image placement markers should be distributed evenly across the post
Step 4: Content Gaps
After generating the outline, add a dedicated content gaps analysis: 1. List 3-5 topics or angles that all top-ranking competitors miss 2. Identify opportunities for original data, case studies, or perspectives 3. Note format advantages this post can have (more visuals, better structure, deeper coverage on a specific subtopic)
Step 5: Save
Save the outline to outlines/[slug]-outline.md or to a user-specified path. Confirm the outline is ready for /blog write to consume.
If the outlines/ directory does not exist, create it.
Related skills
How it compares
Pick blog-outline when you already have a brief and only need heading structure and section budgets; pick blog-brief when competitive stats and image research are still required.
FAQ
What does blog-outline generate?
blog-outline produces an article skeleton with H2/H3 headings, per-section word counts, chart and image markers, FAQ question slots, and internal linking zones. The output is structure only, ready for a drafting step.
How is blog-outline different from blog-brief?
blog-outline is lighter than blog-brief. blog-brief includes full competitive analysis, statistics research, and image suggestions, while blog-outline delivers SERP-informed heading hierarchy and section targets without that deeper research pass.
When should developers invoke blog-outline?
blog-outline fits after an approved brief exists and before full drafting. Trigger it when prompts mention blog outline, article skeleton, heading structure, or section planning for SEO content.