bmad-editorial-review-prose

Reviews prose for communication issues and outputs suggested fixes in a three-column table.

Updated May 7, 2026
One-click install
npx skills add https://github.com/jgabriellima/deep-agent-skill --skill bmad-editorial-review-prose-jgabriellima
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: bmad-editorial-review-prose
Source: https://github.com/jgabriellima/deep-agent-skill/tree/main/skills/bmad-editorial-review-prose
Command: npx skills add https://github.com/jgabriellima/deep-agent-skill --skill bmad-editorial-review-prose-jgabriellima

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Writing often contains grammar errors, unclear phrasing, and inconsistencies that impede reader comprehension, and manual copy-editing is slow and inconsistent. This Skill performs a disciplined editorial review of any text and returns only genuine communication fixes, preserving the author's voice and ideas. ## Core Features & Use Cases - Clinical Prose Review: Identifies communication issues that impede comprehension using Microsoft Writing Style Guide principles as a baseline, never rewriting for mere preference. - Structured Fix Table: Outputs a three-column markdown table (Original Text, Revised Text, Changes) with deduplicated and merged suggestions. - Flexible Inputs: Accepts markdown, plain text, or text-heavy XML, with optional custom style guide overrides and a reader_type setting (humans or llm) to calibrate review priorities. - Use Case: Paste a draft blog post or documentation page and ask for a prose review; receive a precise table of minimal fixes covering grammar, clarity, and consistency while code blocks and frontmatter are skipped. ## Quick Start Review the following draft text for prose issues and list the suggested fixes in a 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 text for prose and clarity issues with AI?▼

Provide the text you want reviewed and ask for a prose review. The Skill analyzes grammar, clarity, and consistency, then returns a three-column table showing the original passage, the suggested revision, and the reason for each change.

What types of content can this editorial review handle?▼

It accepts markdown, plain text, and text-heavy XML as input. Code blocks, frontmatter, and structural markup are automatically detected and skipped so only actual prose is reviewed.

Can I use a custom style guide for the prose review?▼

Yes, pass a style_guide input and it overrides the default Microsoft Writing Style Guide baseline and reader_type priorities. The only rule it cannot override is that the content's ideas must never be changed, only their expression.

What is the difference between humans and llm reader_type?▼

The reader_type parameter calibrates review priorities. The humans setting focuses on clarity, flow, and readability, while the llm setting prioritizes unambiguous references, consistent terminology, explicit structure, and no hedging.

Why did the editorial review return an error about content length?▼

The Skill halts with an error if the input is empty or contains fewer than three words, since such short content cannot be meaningfully reviewed. Provide a cohesive passage of at least three words to proceed.

Does the prose review rewrite my text or change my ideas?▼

No, it never rewrites content or challenges ideas. It applies the minimal fix needed for clarity, preserves intentional stylistic choices and author voice, and phrases uncertain suggestions as queries rather than definitive changes.