bmad-editorial-review-prose

Reviews prose for communication issues and outputs suggested fixes in a three-column table.

2|Updated Apr 19, 2026
One-click install
npx skills add https://github.com/Wizarck/nexandro --skill bmad-editorial-review-prose-wizarck
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: bmad-editorial-review-prose
Source: https://github.com/Wizarck/nexandro/tree/main/skills/bmad-editorial-review-prose
Command: npx skills add https://github.com/Wizarck/nexandro --skill bmad-editorial-review-prose-wizarck

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Unclear or grammatically flawed writing impedes reader comprehension, but manual copy-editing is slow and inconsistent. This Skill applies Microsoft Writing Style Guide principles to detect genuine communication issues in text and proposes minimal, targeted fixes without altering the author's ideas or voice. ## Core Features & Use Cases - Clinical Prose Review: Identifies grammar, clarity, and comprehension issues in markdown, plain text, or text-heavy XML while skipping code blocks and frontmatter. - Style Guide Override: Accepts an optional project-specific style guide that overrides default editorial principles, plus a reader_type mode (humans or llm) to calibrate review priorities. - Structured Output: Returns deduplicated, merged suggestions in a three-column table (Original Text, Revised Text, Changes) with queries for uncertain fixes. - Use Case: Paste a draft documentation page and ask for a prose review; receive a table of minimal corrections such as subject-verb agreement fixes and spelling errors with all occurrence locations listed. ## Quick Start Review the following text for prose issues and output suggested fixes in a table.

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 review text for prose and clarity issues?▼

Provide the text as the content input and the Skill reviews it against Microsoft Writing Style Guide principles. It returns a three-column table showing the original passage, the suggested revision, and an explanation of each change.

What text formats does this editorial review support?▼

The review accepts markdown, plain text, and text-heavy XML as input. Code blocks, frontmatter, and structural markup are automatically detected and skipped so only prose sections are evaluated.

Can I use a custom style guide with the prose review?▼

Yes, pass a style_guide input and it overrides all generic principles, including the Microsoft Writing Style Guide baseline. The only exception is that the content's ideas are never changed, only how they are expressed.

What is the difference between humans and llm reader_type?▼

The humans mode prioritizes clarity, flow, and readability, while the llm mode prioritizes unambiguous references, consistent terminology, and explicit structure. If omitted, reader_type defaults to humans.

Why did the editorial review halt with an error?▼

The review halts if the content is empty or contains fewer than three words, or if reader_type is not 'humans' or 'llm'. Provide at least three words of text and a valid reader_type to proceed.

Does the prose review rewrite my content or change its meaning?▼

No, the review applies minimal intervention only to fix genuine communication issues. It preserves intentional stylistic choices and author voice, and phrases uncertain fixes as queries rather than definitive changes.