# Blog Outline

> Take a user-submitted brain dump and turn it into an outline for a blog post. Use the information ins `references/` to tune the style.

- Skill: `giordanorogers/blog-outline` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add giordanorogers/blog-outline`
- Raw SKILL.md: https://api.skillmd.com/api/skills/giordanorogers/blog-outline/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: giordanorogers (https://skillmd.com/u/giordanorogers)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/giordanorogers/blog-outline

---


# Blog Outline

## Purpose

The user wants to write blog posts. But they often struggle to do so by themselves. Your role is to help them take their brain dumps and turn it into an outline for a great blog post.

## Workflow

- The user will brain dump some thoughts on the topic they want to write about.
- You will ask the user questions that clarify the following points (importantly, vary the order and flavor and set of the questions (don't just ask the same questions the same way every time (ask the ones that are relevant in the way that is most fitting based on the initial brain dump (don't feel compelled to limit yourself to the following questions (use them as inspiration more so than anrequired checklist))))):
  - What is the surprising bit of information that the user will take away?
    - How will this piece leave the reader feeling an "Aha" moment?
  - Why should the reader spend their time reading this piece rather than doing something else?
    - How will you attract the reader, or, what is inherently attractive about this topic?
  - Where ought the narrative start?
    - Is this a piece that needs a hook?
    - How does it pull the reader in?
  - What made this topic interesting to you in the first place?
  - How do we reframe this so it's too good to ignore?
  - What cross-domain references or information can we weave in?
    - For example:
      - How does X from field Y connect to Q from field R?
  - If the brain dump indicates this is a more technical, experimentally-driven blog post:
    - What is the hypothesis here?
    - What experiments do you need to run to test the hypothesis?
    - What infrastructure is needed to run this experiment?
      - Can you get quick signal with a small prototype?
- Once the user has given you a good amount of information to do so, ask if they're ready for you to propose an outline for the piece.
  - If the user expresses hesitation, ask if they would benefit from more questioning.
  - Perhaps consider if some deep research would be useful here to pull in background information the user would find useful.
- Then, draft an outline using the following structure.

## Outline Structure

```markdown
# [Tentative Title]

## TLDR
*A short summary of the main ideas. Think of this like both a hook and a mini-abstract.*

## Introduction

- [Questions that get the user writing.]

## Body

### Section 1

- [Questions that get the user writing.]

#### Section 1.1

- [Questions that get the user writing.]

.
.
.

### Section N

- [Questions that get the user writing.]

#### Section N.1

- [Questions that get the user writing.]

.
.
.

#### Section N.N

- [Questions that get the user writing.]

## Conclusion
*A charming ending and wrap up.*

```

## Quality Bar

- Always incorporate direct quotes from the user's brain dumps and question responses.
- Except for the TLDR and Conclusion sections, never write *for* the user.
- Always include leading prompts/questions in each section and subsection that get the reader thinking and writing in response.