bmad-editorial-review-structure

Analyze document structure and recommend improvements for clarity and flow.

Updated Mar 16, 2026
One-click install
npx skills add https://github.com/JohnnyWang1998/job-market-tracker --skill bmad-editorial-review-structure-johnnywang1998
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bmad-editorial-review-structure
Source: https://github.com/JohnnyWang1998/job-market-tracker/tree/main/_bmad/core/skills/bmad-editorial-review-structure
Command: npx skills add https://github.com/JohnnyWang1998/job-market-tracker --skill bmad-editorial-review-structure-johnnywang1998

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill streamlines the process of reviewing and improving the structural integrity and flow of documents, ensuring information is presented logically and concisely.

Core Features & Use Cases

  • Structural Analysis: Evaluates document organization against best practices for clarity and comprehension.
  • Content Prioritization: Identifies sections that can be cut, merged, or moved to enhance reader focus.
  • Use Case: A technical writer needs to ensure a new user guide is easy to follow, with prerequisites clearly stated before complex steps, and that the overall narrative flows logically from introduction to conclusion.

Quick Start

Use the bmad-editorial-review-structure skill to analyze the provided document content for structural improvements.

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 improve document structure and flow for better reader comprehension?

Analyze document organization against best practices to enhance clarity and reader comprehension. By evaluating section mapping and logical flow against structural models, you can identify content to cut, merge, or move to improve overall document structure.

What is the best way to review and optimize the structure of a technical document?

The best way to review technical documents is to apply a step-by-step validation workflow that evaluates section prioritization and narrative flow. This ensures prerequisites are clearly stated before complex steps, enhancing conciseness and reader focus.

Can I use this structural analysis approach for tutorials and conceptual explanations?

Yes, this structural analysis approach applies to various document types including tutorials, reference materials, and conceptual explanations. It evaluates organization and prioritizes sections to enhance clarity and reader comprehension across different formats.

How do I identify sections to cut, merge, or move when refining document content?

You identify sections to cut, merge, or move by evaluating document organization against structural models and analyzing content prioritization. This process enhances conciseness by ensuring information is presented logically and reader focus is maintained.

Does this document analysis method require a specific workflow for generating recommendations?

Yes, this document analysis method requires adherence to a step-by-step workflow for validation, analysis, and recommendation generation. This structured process ensures accurate evaluation of section mapping and flow for optimal content optimization.