bmad-editorial-review-prose

Review prose for communication issues and output deduplicated fixes in a three-column table.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill resolves unclear, grammatically incorrect, or confusing prose that hinders reader comprehension, eliminating the need for manual copy-editing to improve communication clarity.

Core Features & Use Cases

  • Clinical Copy-Editing: Applies Microsoft Writing Style Guide principles to identify only genuine communication issues, never altering intentional author voice or core content.
  • Flexible Audience Support: Calibrates review focus for either human readers (prioritizing flow and readability) or LLM readers (prioritizing unambiguous terminology and explicit structure).
  • Smart Issue Handling: Deduplicates repeated issues, merges overlapping fixes, and respects optional project-specific style guides as the final authority.
  • Use Case: You have a technical documentation draft with inconsistent terminology and awkward phrasing. Use this Skill to get a minimal list of targeted fixes that improve clarity without changing your original writing style.

Quick Start

Use the bmad-editorial-review-prose skill to review the attached draft of your user guide for communication issues and receive a list of suggested fixes in a clear table format.

Frequently Asked Questions about bmad-editorial-review-prose

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

FAQPage Schema
How do I fix unclear prose in technical documentation without changing my writing style?

To fix unclear prose without altering your writing style, apply clinical copy-editing that identifies genuine communication issues and outputs minimal, deduplicated fixes. This preserves author voice while resolving comprehension impediments.

What is editorial review for prose and how does it handle markdown or XML content?

Editorial review for prose resolves communication issues in markdown, plain text, and text-heavy XML content. It automatically skips code blocks and structural markup, outputting minimal fixes in a three-column table to improve clarity.

Can I use copy editing to improve text clarity specifically for LLM readers?

Yes, you can calibrate copy editing to improve text clarity for LLM readers by prioritizing unambiguous terminology and explicit structure. Alternatively, it can prioritize flow and readability for human audiences.

Does prose editing work with project-specific style guides?

Prose editing works with project-specific style guides by respecting them as the final authority. It deduplicates repeated issues and merges overlapping fixes to ensure communication improvements align with your guidelines.

What is the best way to resolve inconsistent terminology in a user guide draft?

The best way to resolve inconsistent terminology in a user guide draft is applying Microsoft Writing Style Guide principles. This identifies genuine communication issues and generates targeted fixes without altering core content.