What is the McPhee structural diagramming method?

It is a professional technique used to visualize the 'anatomy' of a piece of writing, ensuring that the arrangement of parts creates a logical, engaging, and inevitable flow for the reader.

Can I use this for technical documentation or just creative writing?

It is designed for any complex writing, including technical guides, business reports, and whitepapers where organizing multiple threads of information is critical.

Why does the skill suggest three different structure options?

Exploring multiple structures prevents defaulting to a chronological flow when a different architecture—like a parallel narrative or a circular structure—might serve the material more effectively.

How does this skill help with the 'saggy middle' problem?

The skill uses a 'gold-coin placement strategy,' identifying high-value anecdotes or insights and placing them strategically in the middle sections to keep readers rewarded and engaged.

Writing Structure Planner

Name: Writing Structure Planner
Author: lyndonkl

bylyndonkl

•

コンテンツ管理

Architects complex writing projects using professional diagramming methods to ensure logical flow and reader engagement.

The Writing Structure Planner is a specialized tool for authors, technical writers, and content creators that applies John McPhee’s structural diagramming method to the writing process. Instead of jumping straight into drafting, this skill helps you analyze your raw material, explore multiple organizational frameworks—such as circular, parallel narrative, or inverted pyramid—and strategically place 'gold-coin moments' to maintain reader interest. It provides a visual blueprint and annotated roadmap that ensures your final piece has a clear through-line and 'invisible architecture' that feels natural to the reader.

主な機能

01Produces annotated structural diagrams with transition and pacing guidance.

02Implements 8 professional structure types including List, Chronological, and Dual Profile.

03Strategically maps 'gold-coin moments' to prevent engagement drops in the middle.

0432 GitHub stars

05Analyzes raw material to identify natural organizing principles and key themes.

06Generates three distinct structural options with pros and cons for every project.

ユースケース

01Planning complex technical documentation that must weave together multiple perspectives or data threads.

02Restructuring a disorganized first draft that lacks a clear narrative arc or logical progression.

03Organizing disparate research notes and data points into a cohesive long-form whitepaper or article.

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add lyndonkl/claude writing-structure-planner

For use in Claude.ai and ChatGPT

Download Skill