bmad-editorial-review-structure

Review document structure and produce prioritized editorial recommendations.

Updated Apr 23, 2026
One-click install
npx skills add https://github.com/ncptuan/stock_backtest_project --skill bmad-editorial-review-structure-ncptuan
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bmad-editorial-review-structure
Source: https://github.com/ncptuan/stock_backtest_project/tree/main/.claude/skills/bmad-editorial-review-structure
Command: npx skills add https://github.com/ncptuan/stock_backtest_project --skill bmad-editorial-review-structure-ncptuan

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps when a document feels bloated, poorly ordered, repetitive, or hard to scan, but the underlying ideas should remain unchanged. It gives you a structural editorial review that focuses on cutting waste, improving flow, and preserving comprehension before any copy editing begins.

Core Features & Use Cases

  • Structural Diagnosis: Identifies weak ordering, buried key points, redundant sections, scope drift, and unnecessary detail.
  • Reader-Aware Recommendations: Adapts suggestions for human readers or LLM readers, using different principles for comprehension, density, and precision.
  • Actionable Edit Plan: Produces prioritized recommendations labeled as CUT, MERGE, MOVE, CONDENSE, QUESTION, or PRESERVE, with rationale and estimated impact.
  • Use Case: Review a long tutorial, product brief, internal guide, or prompt document to determine what should move earlier, what should be merged, and what can be removed without changing meaning.

Quick Start

Ask the skill to review the structure of your document for a specific audience and purpose, and request prioritized recommendations to cut, merge, move, or condense sections.

Frequently Asked Questions about bmad-editorial-review-structure

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

FAQPage Schema
How do I improve document structure and flow without changing the underlying meaning?

To improve document structure without altering meaning, use an editorial review process that diagnoses weak ordering and redundancy, then applies prioritized recommendations like CUT, MERGE, MOVE, or CONDENSE to enhance clarity and information density.

What is the best way to restructure a long technical tutorial for faster understanding?

The best way to restructure a long technical tutorial is to perform a structural diagnosis that identifies buried key points and scope drift, then produces an actionable edit plan to improve flow and comprehension for your specific readers.

Can I optimize document structure for both human readers and LLM readers?

Yes, you can optimize document structure for human or LLM readers by applying reader-aware recommendations that adapt principles for comprehension, density, and precision based on the target audience type specified during the editorial review.

How do I review a bloated product brief to identify what sections to cut or merge?

To review a bloated product brief, conduct a structural editorial review that labels sections as CUT, MERGE, MOVE, CONDENSE, QUESTION, or PRESERVE, providing rationale and estimated impact to eliminate waste without losing core ideas.

When should I use an editorial structural review instead of direct copy editing?

You should use an editorial structural review before any copy editing begins when a document feels poorly ordered, repetitive, or hard to scan, ensuring the underlying ideas remain unchanged while improving overall information architecture.

Does an editorial review help reduce information density in strategic documents?

Yes, an editorial review helps manage information density in strategic documents by identifying unnecessary detail and producing prioritized recommendations with comprehension trade-off notes, ensuring high density without sacrificing clarity.