plan-article

Create structured article outlines from research notes with diagram specs.

Updated Feb 22, 2026
One-click install
npx skills add https://github.com/OmuNaman/blog-automation --skill plan-article
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: plan-article
Source: https://github.com/OmuNaman/blog-automation/tree/main/.claude/skills/plan-article
Command: npx skills add https://github.com/OmuNaman/blog-automation --skill plan-article

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Create structured article outlines by turning research notes into a repeatable plan that includes section structure, diagram specifications, and a teaching flow.

Core Features & Use Cases

  • Automatic extraction and synthesis of core concepts from research notes into a multi-level outline with Head 1/Head 2 sections and diagram specs
  • Running example scaffolding and a predefined diagram master list to ensure consistency across posts
  • Output to plan/<topic-slug>_outline.md and an approval-ready draft ready for review

Quick Start

Provide a topic slug that has an existing research/<topic-slug>.md, then run the plan-article skill to generate plan/<topic-slug>_outline.md

Frequently Asked Questions about plan-article

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a structured outline from research notes for a technical blog post?

To create a structured outline from research notes, provide a topic slug matching an existing research note file. The system extracts core concepts and synthesizes them into a multi-level outline with section structure, diagram specifications, and pedagogical teaching flow.

What is the best way to plan diagram specifications for technical articles?

The best way to plan diagram specifications is to enumerate required diagrams during the outline planning phase. This ensures visual aids map directly to the teaching flow and maintains consistency across technical posts using a predefined diagram master list.

How do I scaffold a teaching flow using existing research notes?

You can scaffold a teaching flow by reading existing research notes and applying a defined workflow that plans the pedagogical progression. This process structures concepts into a logical teaching sequence before generating the final outline markdown file.

Do I need a specific file naming format to generate an article outline?

Yes, you need a topic slug that matches an existing research/<topic-slug>.md file. The system reads this specific research note to synthesize the core concepts and outputs the generated plan to plan/<topic-slug>_outline.md.

Can I automatically extract core concepts from markdown research notes into an outline?

Yes, you can automatically extract and synthesize core concepts from markdown research notes. The system processes the notes to generate a multi-level outline featuring Head 1 and Head 2 sections, running example scaffolding, and detailed diagram specifications.

What format does the generated article plan output use?

The generated article plan uses a markdown format and outputs directly to the plan directory. It creates an approval-ready draft saved as plan/<topic-slug>_outline.md, ready for immediate review and downstream drafting.