bmad-editorial-review-prose

Review prose for clarity issues and output minimal revisions in a three-column table.

Updated Apr 23, 2026
One-click install
npx skills add https://github.com/ncptuan/stock_backtest_project --skill bmad-editorial-review-prose-ncptuan
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bmad-editorial-review-prose
Source: https://github.com/ncptuan/stock_backtest_project/tree/main/.claude/skills/bmad-editorial-review-prose
Command: npx skills add https://github.com/ncptuan/stock_backtest_project --skill bmad-editorial-review-prose-ncptuan

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you find and fix communication issues in prose that make writing harder to understand, while preserving the author's meaning, structure, and voice.

Core Features & Use Cases

  • Clinical editorial review: Identifies clarity problems, ambiguous phrasing, grammar issues, and wording that impedes comprehension.
  • Minimal-change revisions: Suggests the smallest possible fixes instead of rewriting for style preference or restructuring the text.
  • Structured output for review: Returns edits in a three-column table showing the original text, revised text, and the reason for the change.
  • Use cases: Review documentation, articles, reports, markdown content, or text-heavy XML for human readers or for clearer machine-readable wording.

Quick Start

Ask the skill to review your draft for prose clarity and return suggested fixes in a three-column 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 markdown prose for clarity without changing the original meaning?

To review markdown prose for clarity, the Skill identifies communication issues and recommends minimal revisions without changing meaning. It returns edits in a three-column table showing the original text, revised text, and the reason for the change.

Can I use this for copy editing text-heavy XML or plain text documentation?

Yes, you can use this for copy editing text-heavy XML or plain text documentation. The Skill applies editorial review to markdown, plain text, and text-heavy XML while preserving the author's structure and voice.

What is the best way to clean up technical writing for an LLM reader?

The best way to clean up technical writing for an LLM reader is to use the Skill's reader-type handling feature. It processes prose specifically for humans or llm, ensuring clearer machine-readable wording without altering the intended message.

Does the editorial review rewrite my entire article or just fix grammar issues?

The editorial review does not rewrite your entire article; it suggests the smallest possible fixes. It identifies grammar issues and ambiguous phrasing, recommending minimal-change revisions instead of rewriting for style preference or restructuring the text.

How are suggested prose revisions formatted for easy review?

Suggested prose revisions are formatted as structured output for review. The Skill returns a three-column table showing the original text, the revised text, and the reason for the change, making it easy to evaluate each edit.

Will copy editing markup tags be modified during the editorial review process?

Markup tags will not be modified during the editorial review process. The Skill features markup skipping and input validation to ensure the preservation of document structure and voice while deduplicating repeated issues.