bmad-editorial-review-prose

Review text for communication issues and output suggested fixes in a three-column table.

Updated Mar 16, 2026
One-click install
npx skills add https://github.com/JohnnyWang1998/job-market-tracker --skill bmad-editorial-review-prose-johnnywang1998
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bmad-editorial-review-prose
Source: https://github.com/JohnnyWang1998/job-market-tracker/tree/main/_bmad/core/skills/bmad-editorial-review-prose
Command: npx skills add https://github.com/JohnnyWang1998/job-market-tracker --skill bmad-editorial-review-prose-johnnywang1998

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill addresses communication issues in text that hinder comprehension, ensuring that the intended message is clear and effectively conveyed.

Core Features & Use Cases

  • Prose Review: Analyzes text for clarity, conciseness, and adherence to writing principles.
  • Issue Identification: Pinpoints specific communication problems that impede understanding.
  • Suggested Fixes: Provides precise, minimal revisions to improve readability.
  • Use Case: A technical writer can use this Skill to review a draft of a user manual, ensuring that complex instructions are easy for end-users to follow.

Quick Start

Use the bmad-editorial-review-prose skill to review the following text for clarity and suggest improvements.

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 prose for clarity and readability issues in markdown or plain text?

Prose review analyzes markdown, plain text, or text-heavy XML for communication issues that impede comprehension, outputting suggested fixes in a three-column table to improve clarity and readability.

What is the best way to copy-edit technical writing for end-user comprehension?

Clinical copy-editing for technical writing applies the Microsoft Writing Style Guide or a custom style guide to pinpoint specific communication problems and provide precise, minimal revisions that enhance reader understanding.

Does prose review work with XML content or just markdown documents?

Prose review works with markdown, plain text, and text-heavy XML content, applying clinical copy-editing techniques to identify communication issues and suggest fixes while preserving the author's voice.

How does the review process handle code blocks and author voice preservation?

The review process includes specific handling for code blocks to avoid unintended modifications and requires validation of input content length and reader type to ensure author voice preservation during clarity improvements.

Can I use a custom style guide instead of the Microsoft Writing Style Guide for text editing?

Text editing supports a provided custom style guide as an alternative to the Microsoft Writing Style Guide, allowing you to tailor prose review and issue identification to your organization's specific writing standards.

What writing issues does a prose review identify that impede reader comprehension?

Prose review identifies clarity, conciseness, and readability issues that hinder comprehension, pinpointing specific communication problems and outputting suggested fixes in a structured three-column table format.