bmad-editorial-review-structure

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

Updated May 7, 2026
One-click install
npx skills add https://github.com/jgabriellima/deep-agent-skill --skill bmad-editorial-review-structure-jgabriellima
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: bmad-editorial-review-structure
Source: https://github.com/jgabriellima/deep-agent-skill/tree/main/skills/bmad-editorial-review-structure
Command: npx skills add https://github.com/jgabriellima/deep-agent-skill --skill bmad-editorial-review-structure-jgabriellima

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 of markdown or plain-text documents and produces prioritized recommendations for cuts, merges, moves, and condensations before any copy editing begins. ## Core Features & Use Cases - Structural Analysis: Maps each section against purpose-matched structure models (tutorial, reference, conceptual, prompt, strategic pyramid) and flags redundancy, scope violations, and buried information. - Audience-Aware Review: Adapts principles for human readers (preserving comprehension aids like examples and summaries) or LLM readers (optimizing for precision, density, and unambiguous references). - Prioritized Recommendations: Outputs categorized actions (CUT, MERGE, MOVE, CONDENSE, QUESTION, PRESERVE) with rationale, word-count impact, and length-target assessment. - Use Case: A technical writer has a 3,000-word onboarding guide that feels bloated. Run this Skill to receive a prioritized list of sections to cut or merge, with an estimated 30% reduction while preserving comprehension aids. ## Quick Start Review the structure of my attached markdown guide and recommend cuts, merges, and reordering to make it 30% shorter for new users.

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 the structure of a markdown document before editing?▼

Run a structural editorial review that maps each section against a purpose-matched structure model, then outputs prioritized CUT, MERGE, MOVE, and CONDENSE recommendations. This runs before copy editing so you fix organization before polishing prose.

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

Structural editing addresses organization, redundancy, and flow at the section level, while copy editing fixes grammar and style at the sentence level. Structural review should run first because rewriting sentences in sections that will later be cut wastes effort.

Can I apply a custom style guide to a document structure review?▼

Yes, provide a style_guide input and it overrides all generic principles, including reader-type priorities and structure model selection. The only exception is that content meaning is never changed, only how ideas are organized and expressed.

How does document review differ for LLM readers versus human readers?▼

For LLM readers, the review optimizes for precision and density: cutting warmth and orientation sections, enforcing consistent terminology, and preferring structured formats. For humans, it preserves comprehension aids like examples, summaries, and visual whitespace.

What are the limitations of an automated structural document review?▼

The review only proposes recommendations and never executes changes, so the author decides what to accept. It also halts on content under three words and requires a valid reader_type of 'humans' or 'llm'.