bmad-editorial-review-prose

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

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill addresses communication breakdowns in text by identifying and suggesting fixes for issues that impede comprehension, ensuring your message is clear and effective.

Core Features & Use Cases

  • Clinical Copy-Editing: Reviews text with a focus on clarity, precision, and adherence to established style principles.
  • Comprehension Focus: Targets issues that hinder understanding, rather than subjective stylistic preferences.
  • Structured Output: Presents suggested fixes in a clear, three-column table for easy review and implementation.
  • Use Case: You've written a technical document and want to ensure it's easily understood by a non-expert audience. This Skill will identify jargon, awkward phrasing, and unclear sentences, providing specific revisions.

Quick Start

Use the bmad-editorial-review-prose skill to review the following content 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 markdown text for clarity and comprehension issues?

To review markdown text for clarity, the Skill validates input content and reader types, then identifies comprehension impediments and outputs suggested fixes in a three-column table.

Can I edit text-heavy XML files for communication issues?

Yes, you can edit text-heavy XML files. The Skill applies clinical copy-editing to various content types including markdown, plain text, and text-heavy XML, prioritizing clarity and minimal intervention.

What is the best way to refine prose for a non-expert audience?

The best way to refine prose for non-experts is to specify the reader type during the editorial review. The Skill identifies jargon and awkward phrasing, providing specific revisions tailored to that audience.

How does clinical copy-editing handle subjective stylistic preferences?

Clinical copy-editing targets issues that hinder understanding rather than subjective stylistic preferences. It focuses on clarity, precision, and adherence to established style principles based on specified reader types.

Do I need a style guide to process plain text for comprehension problems?

No, a style guide is optional. The Skill requires validation of input content and reader type, followed by a detailed editorial review that outputs identified issues in a structured table format.

What format does the structured output use for suggested text fixes?

The structured output for suggested fixes uses a three-column table. This format allows for easy review and implementation of identified communication issues and specific revisions.