bmad-editorial-review-structure

Analyze document structure and generate prioritized editorial recommendations.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Documents often have poor structural organization that buries critical information, includes unnecessary redundancies, and fails to align with their intended purpose and audience, making them hard to scan, understand, and use effectively for time-constrained readers.

Core Features & Use Cases

  • Structured Editorial Review: Follows a 6-step systematic workflow to analyze document structure against purpose, audience, and reader type (human or LLM).
  • Customizable Guidelines: Supports optional project-specific style guides that override default editorial principles to match brand or team requirements.
  • Actionable Recommendations: Generates prioritized, categorized suggestions (cut, merge, move, condense, preserve) with impact estimates to guide document improvements before copy editing.
  • Use Case: Ideal for reviewing long technical documentation, whitepapers, user guides, or internal reports to ensure structure delivers maximum value upfront and eliminates wasteful content.

Quick Start

Use the bmad-editorial-review-structure skill to review the attached document for structural improvements and receive prioritized recommendations to enhance clarity and flow.

Frequently Asked Questions about bmad-editorial-review-structure

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
What is a pre-copy edit structural review for technical documentation?

A pre-copy edit structural review analyzes long-form content like technical documentation to identify redundancies and misalignments with audience, generating prioritized recommendations to cut, merge, or reorganize sections before copy editing.

How do I improve document structure and clarity for long-form content?

Improve document structure by applying a systematic 6-step editorial review workflow that analyzes your document against its purpose, generating actionable suggestions to condense text, eliminate wasteful content, and preserve core information.

Can I use custom style guides for editorial document review?

Yes, you can apply optional project-specific style guides during editorial document review to override default structural editing principles, ensuring the document structure aligns with your specific brand or team requirements.

Does structural editing work for both human and LLM readers?

Yes, structural editing evaluates document organization against the intended reader type, ensuring long-form content like whitepapers and user guides deliver maximum value upfront for both time-constrained human readers and LLM processing.

What is the best way to analyze a poorly structured whitepaper?

The best way to analyze a poorly structured whitepaper is using a systematic editorial review that categorizes actionable recommendations for cuts, reorganization, and simplification while providing impact estimates to guide improvements.

What are the limitations of automated editorial review for technical documents?

Automated editorial review focuses exclusively on pre-copy-edit structural organization and does not perform line-by-line grammar checks, meaning you still need subsequent copy editing to finalize technical document clarity.