Blog Outline Builder

What it does

Takes a working topic, a target keyword, and optionally a few competing URLs or existing site posts, then produces an H2/H3 heading structure with a one-line talking point under each section. It checks the site's existing posts first so the outline does not duplicate a section already covered elsewhere, and flags where an internal link would fit naturally.

Install

This skill isn't packaged in an installable registry. It's a plain SKILL.md file you can copy directly. Copy it from the SKILL.md tab and save it at the path for your assistant:

Use it in your AI assistant

Claude Code

.claude/skills/blog-outline-builder/ (or ~/.claude/skills/blog-outline-builder/ for all projects)

GitHub Copilot (VS Code)

.github/skills/blog-outline-builder/

OpenAI Codex

.codex/skills/blog-outline-builder/

Cursor

.cursor/skills/blog-outline-builder/ (or ~/.cursor/skills/blog-outline-builder/ globally)

Compatibility

Any WordPress site. No special plugin required, though read access to existing posts improves duplicate-topic detection.

The complete SKILL.md for this skill:

---
name: blog-outline-builder
description: Use when a user asks for a post outline, content structure, or heading plan before writing a draft. Triggers on "outline this post", "give me a structure for", or "what headings should this cover".
---

# Blog Outline Builder

## When to use
The user has a topic and target keyword but no draft yet, and wants a heading structure and talking points before committing to full prose.

## Procedure
1. Confirm the topic, target keyword, and intended audience; ask if any are missing or ambiguous.
2. Search existing published posts on the site for overlapping topics, note titles and slugs so the new outline can differentiate or link to them instead of repeating them.
3. Draft an H2-level structure (5 to 8 sections), each with a one-line talking point, ordered so it answers the likely search intent early rather than burying it.
4. Suggest 1 to 3 places an internal link to an existing post would fit naturally within the outline.
5. Present the outline as a numbered list with headings bolded, not as finished prose, so the user can reorder or cut sections before drafting.

## Guardrails
- Do not write full paragraphs under the headings; an outline is talking points only, expanding it into prose is a separate step the user should explicitly request.
- Do not recommend a heading structure that ignores an existing post covering the same angle; flag the overlap instead of silently duplicating it.