bmad-editorial-review-structure

Analyze markdown document structure and propose prioritized cuts, merges, and reorders.

4|Updated Apr 26, 2026
One-click install
npx skills add https://github.com/curdx/curdx-flow --skill bmad-editorial-review-structure-curdx
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bmad-editorial-review-structure
Source: https://github.com/curdx/curdx-flow/tree/main/.agents/skills/bmad-editorial-review-structure
Command: npx skills add https://github.com/curdx/curdx-flow --skill bmad-editorial-review-structure-curdx

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you fix confusing or overgrown document structure by proposing high-value reorganization, cuts, and simplifications that preserve the document’s meaning.

Core Features & Use Cases

  • Structural editorial review that proposes CUT, MERGE, MOVE, CONDENSE, QUESTION, or PRESERVE changes.
  • Runs an ordered analysis pipeline that checks input validity, purpose, structural fit to a structure model, and flow/journey issues.
  • Optimized for either human or LLM readers via reader_type, with optional style_guide overriding default principles.
  • Output includes a document summary, prioritized recommendations, estimated word reduction, and explicit comprehension trade-offs when relevant.

Quick Start

Use the bmad-editorial-review-structure skill to review your markdown document and request prioritized structural recommendations that improve clarity and flow while preserving comprehension.

Frequently Asked Questions about bmad-editorial-review-structure

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

FAQPage Schema
What is editorial review for document structure and how does it improve clarity?

Editorial review for document structure analyzes content organization and flow to propose cuts, merges, reorders, and consolidations that preserve meaning while improving clarity and high-value density for human or LLM readers.

How do I restructure a markdown document to improve flow and readability?

To restructure a markdown document, run an ordered analysis pipeline that validates input, maps content to a structure model, and categorizes prioritized recommendations like CUT, MERGE, MOVE, or CONDENSE with rationales and impact estimates in a standardized markdown output.

Can I optimize technical writing specifically for LLM readers instead of humans?

Yes, you can optimize technical writing for LLM readers by setting a reader_type parameter, which adjusts the editorial review principles to prioritize high-value density and formatting suited for LLM consumption while preserving the document's original meaning.

What is the best way to reduce word count in a document without losing key information?

The best way to reduce word count without losing meaning is to apply structural editorial review that proposes targeted cuts and condensing actions, providing estimated word reduction and explicit comprehension trade-offs for each change.

Does this editorial review process require a specific style guide or audience definition?

No, a style guide and audience definition are optional; the editorial review can apply default principles automatically, but providing purpose, audience, and length targets helps tailor structural recommendations more precisely to your document.

When should I not use an automated document structure reorganization approach?

You should avoid automated document structure reorganization when a document's existing sequence is strictly regulated or sequential, as the review proposes reorders and consolidations that may break mandatory compliance or process flow.