bmad-editorial-review-structure

Analyze markdown or plain-text documents and propose structural cuts, reorganization, and simplification.

Updated May 17, 2026
One-click install
npx skills add https://github.com/thuantan2060/facebook-sale-tracking --skill bmad-editorial-review-structure-thuantan2060
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bmad-editorial-review-structure
Source: https://github.com/thuantan2060/facebook-sale-tracking/tree/main/.agents/skills/bmad-editorial-review-structure
Command: npx skills add https://github.com/thuantan2060/facebook-sale-tracking --skill bmad-editorial-review-structure-thuantan2060

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It removes clutter, redundancy, and misplaced sections from a document’s structure so the reader can understand it faster, with high-value reorganization while preserving the original ideas.

Core Features & Use Cases

  • Structural editorial review: Proposes cuts, reorganization, and simplification focused on comprehension and scan-ability.
  • Model-driven recommendations: Chooses a structure model based on purpose and audience, then checks each section against that model’s primary rules.
  • Reader-mode optimization: Supports both human reading (engagement/comprehension aids) and llm reading (precision/unambiguity), including different pruning priorities.

Quick Start

Use the bmad-editorial-review-structure skill to review your document for structural clarity and flow by providing it as the required input content (and optionally 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 flow without changing the original content?

Editorial review for document structure analyzes headings, lists, and sectioning to reorganize and simplify text. It cuts clutter and redundancy while treating content as sacrosanct, ensuring the underlying ideas remain completely unchanged during the reorganization process.

What is structural editorial review for markdown and plain-text documents?

Structural editorial review is a pre-copyediting pass that evaluates document comprehension and scan-ability. It applies a model-driven approach to infer purpose, analyze structure, and output prioritized recommendations for cutting, reorganizing, and simplifying content.

How do I optimize technical writing for both human readers and LLM processing?

Technical writing can be optimized for dual reader types by applying structural editorial review. The process selects distinct pruning priorities, using engagement aids for human comprehension and precision-focused unambiguity rules for LLM reading.

Can I use editorial review to tighten document structure for a specific target audience?

Yes, editorial review can tighten document structure for specific audiences by accepting target audience and purpose as inputs. It chooses a structure model based on these parameters and validates each section against that model's primary rules.

Does editorial review for document structure alter my original ideas during simplification?

No, editorial review for document structure preserves your original ideas entirely. It enforces a strict validation process where content is sacrosanct, meaning recommendations only address layout, flow, and redundancy without modifying the underlying meaning.