bmad-editorial-review-structure

Reviews document structure and proposes prioritized cuts, merges, and reorganization recommendations.

Updated Mar 20, 2026
One-click install
npx skills add https://github.com/LinCie/bearuang --skill bmad-editorial-review-structure-lincie
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: bmad-editorial-review-structure
Source: https://github.com/LinCie/bearuang/tree/main/.opencode/skills/bmad-editorial-review-structure
Command: npx skills add https://github.com/LinCie/bearuang --skill bmad-editorial-review-structure-lincie

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Documents often suffer from bloated sections, buried critical information, and poor flow that waste reader attention. This Skill performs a structural editorial review that identifies what to cut, merge, move, or condense while preserving comprehension. ## Core Features & Use Cases - Structural Analysis: Maps each section against purpose-driven structure models (tutorial, reference, conceptual, prompt, strategic) and flags redundancy, scope violations, and buried information. - Audience-Aware Review: Adapts principles for human readers (preserving comprehension aids) or LLM readers (optimizing for precision and density), with optional style guide overrides. - Prioritized Recommendations: Outputs categorized recommendations (CUT, MERGE, MOVE, CONDENSE, QUESTION, PRESERVE) with rationale, word-count impact, and length-target assessment. - Use Case: Paste a lengthy product requirements document and receive a prioritized list of structural changes estimated to reduce length by 30% while keeping the conclusion-first pyramid structure intact. ## Quick Start Ask the AI to perform a structural editorial review of your document, optionally specifying the 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 get a structural review of my document?▼

Provide your document content and request a structural editorial review. The Skill maps each section, evaluates it against a structure model, and returns prioritized CUT, MERGE, MOVE, and CONDENSE recommendations with word-count impact estimates.

What is the difference between structural editing and copy editing?▼

Structural editing addresses organization, section order, redundancy, and information density before any sentence-level work. This Skill runs before copy editing, since fixing grammar in sections that will be cut wastes effort.

Can I review documentation written for LLM consumption?▼

Yes, set reader_type to 'llm' and the review optimizes for precision and unambiguity rather than human engagement. It favors explicit definitions, consistent terminology, and structured formats over warmth and comprehension aids.

Does the structural review rewrite my document automatically?▼

No, the Skill only proposes recommendations and never modifies content directly. You decide which suggestions to accept, and the output includes rationale and estimated word savings for each recommendation.

What happens if my document is too short to review?▼

The Skill halts with an error if the content is empty or contains fewer than three words, since substantive structural analysis requires a minimum amount of material. It also halts if reader_type is not 'humans' or 'llm'.