content-outlining
Create structured content outlines for articles, blog posts, documentation, and long-form content. Use this skill when planning written content before drafting.
Best use case
content-outlining is best used when you need a repeatable AI agent workflow instead of a one-off prompt.
Create structured content outlines for articles, blog posts, documentation, and long-form content. Use this skill when planning written content before drafting.
Teams using content-outlining should expect a more consistent output, faster repeated execution, less prompt rewriting.
When to use this skill
- You want a reusable workflow that can be run more than once with consistent structure.
When not to use this skill
- You only need a quick one-off answer and do not need a reusable workflow.
- You cannot install or maintain the underlying files, dependencies, or repository context.
Installation
Claude Code / Cursor / Codex
Manual Installation
- Download SKILL.md from GitHub
- Place it in
.claude/skills/content-outlining/SKILL.mdinside your project - Restart your AI agent — it will auto-discover the skill
How content-outlining Compares
| Feature / Agent | content-outlining | Standard Approach |
|---|---|---|
| Platform Support | Not specified | Limited / Varies |
| Context Awareness | High | Baseline |
| Installation Complexity | Unknown | N/A |
Frequently Asked Questions
What does this skill do?
Create structured content outlines for articles, blog posts, documentation, and long-form content. Use this skill when planning written content before drafting.
Where can I find the source code?
You can find the source code on GitHub using the link provided at the top of the page.
Related Guides
SKILL.md Source
# Content Outlining
You are a content strategist specializing in outline creation. When asked to outline content, follow these frameworks to create a structured plan before writing.
## Outline Process
### Step 1: Define the Brief
Before outlining, clarify these questions:
- **Topic**: What exactly are we writing about?
- **Audience**: Who is the reader? (Beginner / Intermediate / Expert)
- **Goal**: What should the reader know or do after reading?
- **Format**: Blog post? Tutorial? Documentation? Newsletter?
- **Length**: Short (500-800), Medium (1000-1500), Long (2000+)?
- **Keyword** (if SEO): What's the primary search term?
### Step 2: Choose a Framework
Select the outline framework that matches the content type:
#### Framework: Problem-Solution (Blog Posts)
```
I. Hook — state the problem the reader faces
II. Context — why this problem matters now
III. Root Cause — what causes this problem
IV. Solution — your proposed approach
A. Step/Point 1
B. Step/Point 2
C. Step/Point 3
V. Results/Proof — evidence this works
VI. Conclusion — summary + CTA
```
#### Framework: AIDA (Marketing Content)
```
I. Attention — grab with hook/statistic/story
II. Interest — build curiosity with context and stakes
III. Desire — show the solution and its benefits
IV. Action — tell the reader exactly what to do next
```
#### Framework: Tutorial (How-To Guides)
```
I. What We're Building/Doing (with screenshot/demo)
II. Prerequisites
III. Step 1: [First Action]
- Substep with explanation
- Expected result
IV. Step 2: [Second Action]
...
V. Verification — how to confirm it works
VI. Troubleshooting — common issues
VII. Next Steps — what to learn next
```
#### Framework: Comparison (X vs Y)
```
I. Introduction — what we're comparing and why
II. Quick Summary Table
III. Category 1: [Aspect]
A. Option X
B. Option Y
C. Winner and why
IV. Category 2: [Aspect]
...
V. Use Case Recommendations
VI. Final Verdict
```
#### Framework: Listicle (Top N Things)
```
I. Introduction — why this list matters
II. Item 1: [Name] — [One-sentence summary]
- Key benefit
- Example or use case
III. Item 2: [Name]
...
IV. Honorable Mentions (optional)
V. How to Choose — decision criteria
VI. Conclusion
```
#### Framework: Deep Dive (Technical/Research)
```
I. Executive Summary (2-3 sentences)
II. Background — what the reader needs to know
III. Core Concept 1
A. Explanation
B. Example
C. Implications
IV. Core Concept 2
...
V. Practical Applications
VI. Limitations and Caveats
VII. Conclusion and Future Outlook
```
### Step 3: Fill the Skeleton
For each section in the outline:
- Write a **1-sentence summary** of what the section covers
- Note any **key points, data, or examples** to include
- Estimate **word count** for each section
- Flag any **research needed** before writing
### Step 4: Validate the Outline
Check that the outline:
- [ ] Flows logically — each section builds on the previous
- [ ] Has no gaps — a reader won't be left confused
- [ ] Matches the brief (audience, goal, length)
- [ ] Covers the topic competitively (at least as thorough as existing content)
- [ ] Includes a clear CTA or next step at the end
## Outline Output Format
Present outlines in this format:
```markdown
# Outline: [Title]
**Type**: [Blog / Tutorial / Documentation / ...]
**Audience**: [Level]
**Target Length**: [X words]
**Keyword**: [primary keyword if SEO]
---
## I. [Section Title] (~X words)
[1-sentence summary of what this section covers]
- Key point 1
- Key point 2
- [Research needed: ...]
## II. [Section Title] (~X words)
...
---
**Total estimated length**: X words
**Key research items**: [list anything that needs fact-checking or sourcing]
```
## Tips for Strong Outlines
- **Front-load value** — put the most useful section early, not buried at the end
- **Use parallel structure** in headings — if one starts with a verb, they all should
- **Plan for visuals** — note where diagrams, screenshots, or code examples belong
- **Include transitions** — note how sections connect ("This leads to...", "Building on this...")
- **Leave room for discovery** — outlines are plans, not prisons. Adjust while writing.Related Skills
url-content-loading
A URL content loading tool that extracts text or metadata from URLs across multiple platforms (YouTube, PTT, Twitter/X, Truth Social, Reddit, GitHub, and more). Use this when you need to load and extract content from social posts, videos, documents, or code repositories for scraping, data extraction, or content analysis.
medium-content-pro
Philosophy-first writing partner for Medium with tactical depth. Combines human storytelling values with production-ready technical content tools. Six content modes based on staff pick analysis, mode-specific quality gates, evidence requirements, annotated examples, and comprehensive scripts integration. Designed for sustainable practice, not algorithm gaming.
apps-ose-platform-web-developing-content
Guide for creating content on ose-platform-web Hugo site using PaperMod theme. Covers English-only landing page structure, update posts with date-prefixed filenames, PaperMod frontmatter (cover images, table of contents, author field), simple flat organization, and ose-platform-web specific conventions. Essential for ose-platform-web content creation tasks
apps-ayokoding-web-developing-content
Comprehensive guide for creating content on ayokoding-web Hugo site using Hextra theme. Covers bilingual content strategy (default English), level-based weight ordering system, by-example tutorial annotation standards (1-2.25 comments per code line), absolute path linking requirements, and ayokoding-web specific frontmatter patterns. Essential for content creation tasks on ayokoding-web
hig-components-content
Apple Human Interface Guidelines for content display components.
web-content
SEO and AI discovery (GEO) - schema, ChatGPT/Perplexity optimization
tripadvisor-content-api-automation
Automate TripAdvisor tasks via Rube MCP (Composio). Always search tools first for current schemas.
notion-content
Create content records in Notion database after publishing articles. Use when user provides article title and publishing links (zhihu, weixin, baidu, sohu, toutiao, x.com). Auto-detects platform from URL, fills publish date. Trigger on "/notion-content", "notion记录", "内容入库", or when user says they published an article with links.
contentful-graphql-automation
Automate Contentful Graphql tasks via Rube MCP (Composio). Always search tools first for current schemas.
content_strategist
Creates high-quality, SEO-optimized content that ranks in search engines. Applies on-page SEO best practices, keyword optimization, and content structure for maximum visibility and engagement.
wechat-content-skill
公众号内容创作助手 - 帮助高效采集素材、筛选选题、创作优质文章
social-content
When the user wants help creating, scheduling, or optimizing social media content for LinkedIn, Twitter/X, Instagram, TikTok, Facebook, or other platforms. Also use when the user mentions 'LinkedIn post,' 'Twitter thread,' 'social media,' 'content calendar,' 'social scheduling,' 'engagement,' or 'viral content.' This skill covers content creation, repurposing, and platform-specific strategies.