editorial-review

Analyze long-form document structure and propose reorganization plans.

10|1|Updated Jun 29, 2026

Search Tags:#writing #optimization #structure #review #editorial #argument

Ready to run

npx skills add https://github.com/mishahanin/heading-os --skill editorial-review-mishahanin

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: editorial-review
Source: https://github.com/mishahanin/heading-os/tree/main/.claude/skills/editorial-review
Command: npx skills add https://github.com/mishahanin/heading-os --skill editorial-review-mishahanin

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires python3, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This skill solves the problem of disorganized, structurally weak long-form deliverables by providing a systematic, objective review of a document's argument architecture before any prose-level editing occurs.

Core Features & Use Cases

Structural Mapping: Identifies section ordering, claim-to-evidence linkage, and hierarchy issues.
Operation-Based Editing: Proposes specific structural changes like CUT, MERGE, MOVE, or CONDENSE with word-savings estimates.
Use Case: Use this when you have a draft proposal or investor memo that feels disjointed or lacks a clear argument arc, ensuring the structure is sound before refining the prose.

Quick Start

Run the editorial review skill on your draft by typing /editorial-review file:path/to/your/document.md to receive a structural critique and proposed reorganization plan.

Frequently Asked Questions about editorial-review

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

FAQPage Schema

How do I review the structural flow of a long-form proposal before editing the prose?▼

To review the structural flow of a long-form proposal, perform document-level structural analysis targeting argument architecture and section hierarchy. This identifies claim-to-evidence linkage issues and proposes specific reorganization operations like CUT, MERGE, MOVE, or CONDENSE to fix disjointed sections.

What is structural editing for high-stakes documents like investor memos and reports?▼

Structural editing for high-stakes documents is a systematic review of a document's argument architecture before prose-level humanization. It identifies section ordering and hierarchy issues, ensuring the logical flow and argument arc of proposals, briefs, and reports are structurally sound.

How do I fix a disjointed draft document that lacks a clear argument arc?▼

To fix a disjointed draft lacking a clear argument arc, apply operation-based editing that proposes specific structural changes like CUT, MERGE, MOVE, or CONDENSE. This provides word-savings estimates and reorganizes section hierarchy to resolve logical flow issues in long-form deliverables.

Does editorial structural analysis require Python to run?▼

Yes, editorial structural analysis requires Python to run its elicitation scripts. You must also adhere to predefined document-model arcs to ensure structural integrity and proper mapping of claim-to-evidence linkages during the review process.

Can I use structural reorganization for short business emails and quick notes?▼

Structural reorganization is designed for long-form deliverables like proposals, investor memos, and briefs. It targets document-level argument architecture and section hierarchy, making it unsuitable for short business emails that do not require predefined document-model arcs.

What's the best way to identify claim-to-evidence linkage issues in a draft report?▼

The best way to identify claim-to-evidence linkage issues in a draft report is through structural mapping. This process targets section ordering and hierarchy issues, proposing specific structural changes such as MOVE or CONDENSE to ensure the argument architecture is sound.