bmad-editorial-review-structure

Review document structure and propose clarity and brevity improvements.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill provides a comprehensive structural review of documents, proposing cuts, reorganization, and simplification to enhance clarity and flow.

Core Features & Use Cases

  • Structural Analysis: Reviews document structure and proposes changes to improve clarity and flow.
  • Customization: Allows for the application of project-specific style guides.
  • Targeted Optimization: Optimizes for both human and AI readers, with options for different reader types.
  • Use Case: Ideal for editors and writers seeking to refine the structure of technical documents, tutorials, or any text intended for publication.

Quick Start

Run the bmad-editorial-review-structure skill on your document to receive recommendations 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 for better clarity and brevity?

To improve document structure, you need an editorial review that analyzes content flow and proposes targeted cuts, reorganization, and simplification for enhanced readability. This process optimizes text specifically for both human and AI readers.

What is editorial review for document structure and when do I need it?

Editorial review for document structure is the process of analyzing text organization to propose changes that improve flow. You need it when refining technical documents, tutorials, or publication-ready text to ensure your message is clear and concise.

How do I optimize technical documents for AI readers?

You optimize technical documents for AI readers by applying structural analysis that considers the specific reader type and purpose. This targeted optimization adjusts content structure to ensure automated systems can parse the information effectively.

Can I apply a custom style guide during content refinement?

Yes, you can apply project-specific style guides during content refinement. This customization ensures that proposed structural changes and simplifications align with your established formatting and tone requirements.

What is the best way to reorganize a tutorial for better flow?

The best way to reorganize a tutorial is to perform a comprehensive structural review that identifies sections to cut, reorder, and simplify. This approach enhances clarity and flow by targeting optimization based on the reader's needs.

Does document analysis work for both human and AI readers?

Yes, document analysis works for both human and AI readers by offering targeted optimization options for different reader types. It evaluates your content structure to ensure the text is accessible and logically formatted for the intended audience.