bmad-editorial-review-prose

Reviews clinical text and outputs a three-column markdown table of suggested fixes.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The skill helps users improve clinical or technical prose by identifying communication issues that impede understanding and suggesting concise, minimal fixes, ensuring clarity without altering the author's intent.

Core Features & Use Cases

  • Input Validation: Checks content length and reader type before proceeding.
  • Style Guide Override: Allows a custom style guide to supersede default Microsoft Writing Style principles.
  • Focused Review: Detects and skips code blocks, frontmatter, and markup, concentrating only on prose.
  • Three‑Column Output: Generates a markdown table with original text, revised text, and change explanations.
  • Use Cases: Reviewing patient education materials, clinical trial documents, research abstracts, or any health‑care communication that requires clear, jargon‑free language.

Quick Start

Provide your clinical text (and optionally a style guide) to the skill and receive a table of editorial suggestions.

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 clinical prose for clear communication?

To review clinical prose, submit your markdown, plain text, or XML content to receive a three-column markdown table of suggested fixes. This review identifies communication issues that hinder comprehension and suggests concise, minimal fixes without altering the author's original intent.

What is the best way to simplify jargon in patient education materials?

Simplifying jargon in patient education materials involves identifying complex clinical text and generating minimal revisions for clarity. You can provide an optional reader type to ensure the suggested fixes target the correct audience comprehension level.

Can I use a custom style guide to review clinical text?

Yes, you can use a custom style guide to review clinical text by providing it as an input alongside your content. The custom style guide will supersede the default Microsoft Writing Style principles during the editorial review process.

Does the clinical prose review process modify code blocks or frontmatter?

The clinical prose review process does not modify code blocks, frontmatter, or markup. It concentrates exclusively on prose text within your content and detects structural elements to skip them during the editorial review.

What format does the clinical editorial review output use?

The clinical editorial review outputs a three-column markdown table containing the original text, the revised text, and an explanation for each change. This structured format highlights communication issues and their suggested fixes for clinical trial documents and research abstracts.