bmad-editorial-review-structure

Propose prioritized CUT, MERGE, MOVE, CONDENSE, QUESTION, and PRESERVE recommendations for markdown or plain-text documents.

36|16|Updated May 1, 2026
One-click install
npx skills add https://github.com/tronghieu/lumina-wiki --skill bmad-editorial-review-structure-tronghieu
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bmad-editorial-review-structure
Source: https://github.com/tronghieu/lumina-wiki/tree/main/.agents/skills/bmad-editorial-review-structure
Command: npx skills add https://github.com/tronghieu/lumina-wiki --skill bmad-editorial-review-structure-tronghieu

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps you fix confusing or bloated document structure by proposing targeted cuts, reorganization, and simplifications that preserve the underlying meaning while improving comprehension and readability.

Core Features & Use Cases

  • Structural editorial review: Identifies sections and elements to cut, merge, move, condense, or preserve to improve clarity and flow.
  • Comprehension-preserving density: Optimizes for high-value density and reduces redundancy without altering sacrosanct content.
  • Model-aware structuring: Selects and follows a structural model based on purpose and audience (e.g., tutorial/guide, reference/database, conceptual, functional, pyramid).
  • Reader-mode support: Adjusts recommendations using human vs llm reader principles (including validation steps and explicit ordering).
  • Output as recommendations: Proposes changes instead of executing edits so the author keeps control.

Quick Start

Ask for a structural editorial review of your document by providing it as the required content input, e.g., “Review the following document structure and propose the highest-impact cuts and reorganizations to improve clarity while preserving all meaning.”

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 restructure a markdown document to improve clarity and flow?

Restructuring a markdown document involves analyzing its structure and proposing targeted cuts, reorganizations, and simplifications. This process preserves the underlying meaning while improving comprehension and readability through prioritized actions.

What is the best way to simplify technical writing without losing key information?

Simplifying technical writing without losing information requires applying comprehension-preserving density. This method identifies high-value content to preserve while proposing cuts, merges, and condensations that reduce redundancy without altering sacrosanct ideas.

How does editorial review work for optimizing plain-text documents for LLM readers?

Editorial review for LLM readers works by applying specific structural models and explicit ordering principles. It analyzes the document's purpose and proposes structural adjustments optimized for how language models process and extract information.

Can I get document structure recommendations without automatically applying the edits?

Yes, document structure recommendations are proposed as actions rather than executed automatically. The system outputs prioritized CUT, MERGE, MOVE, CONDENSE, and PRESERVE suggestions with estimated impacts, keeping the author in full control of final edits.

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

A structural editorial review should be used before copy editing when a document suffers from confusing organization or bloated flow. It focuses on high-level structural models and density optimization rather than sentence-level grammar or spelling corrections.

Does the document simplification process support different structural models for tutorials and references?

Yes, the document simplification process selects and follows structural models based on the document's purpose and audience. It applies specific frameworks for tutorials, guides, reference databases, and conceptual content to ensure appropriate structural alignment.