bmad-editorial-review-prose

Review prose for communication issues and output suggested revisions in a three-column table.

1|Updated May 16, 2026
One-click install
npx skills add https://github.com/enigmaicon-eng/AI-Enterprise-OS --skill bmad-editorial-review-prose-enigmaicon-eng
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bmad-editorial-review-prose
Source: https://github.com/enigmaicon-eng/AI-Enterprise-OS/tree/main/examples/BMAD-METHOD/src/core-skills/bmad-editorial-review-prose
Command: npx skills add https://github.com/enigmaicon-eng/AI-Enterprise-OS --skill bmad-editorial-review-prose-enigmaicon-eng

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps you identify and fix communication problems in text that reduce comprehension, without rewriting ideas or changing author intent.

Core Features & Use Cases

  • Communication clarity review: Detects prose issues that impede understanding and proposes minimal fixes.
  • Structured revision output: Produces suggested edits in a three-column table format for quick comparison.
  • Context-safe editing: Avoids code/markup areas and preserves content exactly, only improving expression where needed.

Quick Start

Ask a model to review the provided text for communication issues that impede comprehension and to return a three-column table of the original text, revised text, and change rationale using minimal intervention.

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 without changing the original meaning?

To review prose for clarity without altering meaning, apply minimal edits that fix communication issues impeding comprehension. This process identifies specific problem areas and suggests precise revisions while preserving the author's original intent and ideas.

Can I run copyediting on markdown files without breaking code blocks?

Yes, copyediting can safely process markdown files by skipping code blocks, frontmatter, and structural markup. The review targets only text-heavy inputs, ensuring that structural elements and code snippets remain exactly as written.

What is the best way to present suggested text revisions for quick comparison?

The best way to present suggested text revisions is a three-column table format showing the original text, revised text, and change rationale. This structured output allows readers to quickly compare differences and understand why each edit was made.

Does editorial review work with XML text-heavy inputs?

Yes, editorial review works with XML text-heavy inputs, as well as markdown and plain text. The process skips structural markup and focuses entirely on reviewing the prose content to identify and resolve communication issues.

What happens if my text does not meet minimum requirements for prose clarity review?

If text does not meet minimum requirements for prose clarity review, the process triggers a halt behavior and stops. It requires validation of content length and reader_type before proceeding with deduplication and conflict-free merging of fixes.