bmad-editorial-review-structure

Review document structure and propose prioritized cuts, reorganization, and simplification.

Updated Apr 2, 2026
One-click install
npx skills add https://github.com/amitmishra-byldd/Bmad-Note-Maker --skill bmad-editorial-review-structure-amitmishra-byldd
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bmad-editorial-review-structure
Source: https://github.com/amitmishra-byldd/Bmad-Note-Maker/tree/main/_bmad/core/bmad-editorial-review-structure
Command: npx skills add https://github.com/amitmishra-byldd/Bmad-Note-Maker --skill bmad-editorial-review-structure-amitmishra-byldd

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill identifies structural weaknesses in documents and proposes cuts, reorganization, and simplification to increase information density while preserving comprehension.

Core Features & Use Cases

  • Structural diagnosis: Maps headings and sections, detects buried key points, redundancies, scope violations, and misplaced detail.
  • Actionable recommendations: Prioritized CUT/MERGE/MOVE/CONDENSE suggestions with one-sentence rationales and estimated word impact.
  • Audience- and format-aware: Adapts analysis for human or LLM readers and honors a provided style guide while treating content as sacrosanct.
  • Use Case: Use on drafts, tutorials, reports, or product docs to shorten and reorganize content before copy editing.

Quick Start

Request a step-by-step structural review by supplying the document content and optional parameters: style_guide, purpose, target_audience, reader_type, and length_target.

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 reduce fluff in long-form articles?

To improve document structure and reduce fluff, you can perform an editorial structural review that maps headings, detects buried key points, and proposes prioritized CUT, MERGE, MOVE, or CONDENSE actions to increase information density while preserving comprehension.

What is structural editing and how does it help content optimization?

Structural editing analyzes document flow to identify redundancies, scope violations, and misplaced detail, then proposes reorganization and simplification recommendations to increase high-value density before copy editing begins.

How do I shorten a tutorial or report without losing key information?

You can shorten a tutorial or report by applying prioritized structural recommendations that condense text and reorganize sections, providing actionable cuts with estimated word impact and one-sentence rationales to preserve comprehension.

Can I apply a custom style guide during an editorial review of Markdown content?

Yes, you can supply plain text or Markdown content along with an optional style guide, purpose, target audience, and length target, and the structural review will honor the style guide while treating your content as sacrosanct.

Does structural editing work for content intended for LLM readers instead of humans?

Yes, the structural review adapts its analysis based on the reader type, allowing you to optimize document structure and flow specifically for human or LLM readers by accepting a reader_type parameter.

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

You should request an editorial structural review before copy editing when you need to shorten and reorganize drafts, tutorials, reports, or product docs to resolve structural weaknesses and improve flow prior to line-level refinement.