bmad-editorial-review-prose

Review prose for clarity, flow, and terminology consistency in markdown, plain text, and XML.

1|Updated Mar 31, 2026
One-click install
npx skills add https://github.com/mol4/BMAD-Board --skill bmad-editorial-review-prose-mol4
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bmad-editorial-review-prose
Source: https://github.com/mol4/BMAD-Board/tree/main/BMAD%20board/.agents/skills/bmad-editorial-review-prose
Command: npx skills add https://github.com/mol4/BMAD-Board --skill bmad-editorial-review-prose-mol4

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill finds communication issues in prose that make text harder to understand and suggests the smallest possible fixes.

Core Features & Use Cases

  • Reviews markdown, plain text, and text-heavy XML while skipping code blocks, frontmatter, and other structural markup.
  • Flags clarity problems such as awkward phrasing, grammar errors, inconsistent terminology, and unclear references.
  • Produces a three-column table with original text, revised text, and a short explanation, or reports that no editorial issues were found.
  • Use it when you need a disciplined copy-edit of documentation, product writing, or AI-generated text without changing the underlying meaning.

Quick Start

Paste the text you want reviewed and ask for an editorial review focused on communication issues while preserving meaning and any provided style guide.

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 copyedit markdown documentation without altering the original meaning?

To copyedit markdown documentation without altering meaning, you can review prose for clarity, flow, and terminology consistency while preserving structural markup and skipping code blocks. This process flags awkward phrasing and suggests minimal revisions.

Can I review text-heavy XML for grammar and clarity issues?

Yes, you can review text-heavy XML for grammar and clarity issues. The editorial review process skips structural markup and frontmatter, focusing strictly on the prose to flag communication problems and suggest minimal revisions that preserve the underlying structure.

What is the best way to enforce a style guide on AI-generated text?

The best way to enforce a style guide on AI-generated text is to apply a disciplined editorial review that flags inconsistent terminology and awkward phrasing. This process generates minimal revision suggestions that honor the provided style guide constraints.

Does prose review preserve code blocks and frontmatter in plain text files?

Yes, prose review preserves code blocks and frontmatter in plain text files. The process specifically skips structural markup, frontmatter, and code blocks, dedicating analysis exclusively to the surrounding prose to ensure technical formatting remains completely untouched.

How do I fix unclear references and inconsistent terminology in product writing?

You fix unclear references and inconsistent terminology in product writing by running an editorial review that identifies these specific communication issues. It returns a three-column table showing the original text, revised text, and a short explanation for each fix.

What are the limitations of automated prose review for documentation?

A limitation of automated prose review is that it focuses strictly on communication issues impeding comprehension, meaning it will not restructure your document or alter the underlying meaning, and it skips code blocks and frontmatter entirely during analysis.