bmad-editorial-review-structure

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

Updated May 22, 2026
One-click install
npx skills add https://github.com/Asygnuz-S-A-S/one-star --skill bmad-editorial-review-structure-asygnuz-s-a-s
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: bmad-editorial-review-structure
Source: https://github.com/Asygnuz-S-A-S/one-star/tree/main/.claude/skills/bmad-editorial-review-structure
Command: npx skills add https://github.com/Asygnuz-S-A-S/one-star --skill bmad-editorial-review-structure-asygnuz-s-a-s

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 before any copy editing happens. ## Core Features & Use Cases - Structural Analysis: Maps each section against a selected structure model (tutorial, reference, conceptual, prompt, or strategic pyramid) and flags sections that fail to serve the document's purpose. - Reader-Type Optimization: Applies different principles for human readers (preserving comprehension aids like examples and summaries) versus LLM readers (optimizing for precision and unambiguous references). - Prioritized Recommendations: Outputs categorized recommendations (CUT, MERGE, MOVE, CONDENSE, QUESTION, PRESERVE) with rationale and estimated word-count impact. - 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, such as cutting a redundant FAQ and moving prerequisites before the first tutorial step. ## Quick Start Review the structure of my attached markdown guide and propose cuts and reorganization 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 the structure of a markdown document?▼

Provide the document content to the structural review, which maps each section against an appropriate structure model and outputs categorized recommendations. It identifies sections to cut, merge, move, or condense with rationale and estimated word savings.

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

Structural editing addresses organization, redundancy, and flow at the section level and runs before copy editing. Copy editing handles sentence-level grammar and style only after the document's structure is finalized.

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

Yes, pass a style_guide input and it overrides all generic principles in the review, including reader-type priorities and structure model selection. The only exception is that content meaning is never changed, only its organization.

How does document optimization differ for LLM readers versus humans?▼

For LLM readers the review prioritizes precision, consistent terminology, and explicit definitions while cutting warmth and orientation sections. For humans it preserves comprehension aids like examples, summaries, diagrams, and encouraging tone.

What are the limitations of automated structural review?▼

The review only proposes recommendations and never modifies the document directly; the author decides what to accept. It also halts on content under three words and never challenges the substance of ideas, only their organization.