bmad-editorial-review-structure

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

Updated Apr 9, 2026
One-click install
npx skills add https://github.com/5onyy/essential-ai-agent-skills --skill bmad-editorial-review-structure-5onyy
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: bmad-editorial-review-structure
Source: https://github.com/5onyy/essential-ai-agent-skills/tree/main/.cursor/skills/bmad-editorial-review-structure
Command: npx skills add https://github.com/5onyy/essential-ai-agent-skills --skill bmad-editorial-review-structure-5onyy

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Documents often accumulate redundant sections, buried critical information, and poor flow that reduce clarity. This Skill performs a structural editorial review that identifies what to cut, merge, move, or condense while preserving reader comprehension. ## Core Features & Use Cases - Structural Analysis: Maps each section against purpose-driven structure models (tutorial, reference, conceptual, prompt, strategic) to find misalignment. - Prioritized Recommendations: Outputs categorized actions (CUT, MERGE, MOVE, CONDENSE, QUESTION, PRESERVE) with rationale and word-count impact estimates. - Audience-Aware Review: Applies different principles for human readers versus LLM consumers, and supports custom style guide overrides. - Use Case: A technical writer has a 3,000-word onboarding guide that feels bloated. Run this Skill to get a prioritized list of structural changes that could cut 30% of the length without losing comprehension aids. ## Quick Start Review the structure of my attached markdown guide and recommend cuts, merges, and reordering to make it 30% shorter.

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 review a document's structure before copy editing?▼

Run a structural review first to identify sections to cut, merge, move, or condense before polishing prose. This Skill maps each section against the document's purpose and outputs prioritized recommendations with rationale and estimated word savings.

How to reduce document length without losing important information?▼

Structural editing targets true redundancy, scope violations, and buried information rather than comprehension aids like examples and summaries. Each recommendation includes a word-count impact estimate so you can verify it meets your length target.

Can I apply a custom style guide during structural review?▼

Yes, pass a style_guide input and it overrides all default principles, including human-reader and LLM-reader priorities. The only exception is that content meaning is never changed, only how it is organized.

What is the difference between reviewing for humans versus LLM readers?▼

Set reader_type to 'humans' to preserve comprehension aids like summaries, examples, and visual whitespace. Set it to 'llm' to optimize for precision, consistent terminology, and explicit definitions while cutting warmth and orientation sections.

When should structural review not be used?▼

Do not use it for copy editing tasks like grammar, tone, or word choice, since it only proposes organizational changes. It also halts on content under 3 words and never rewrites content directly, only recommends changes.