bmad-editorial-review-prose

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

Updated Mar 20, 2026
One-click install
npx skills add https://github.com/LinCie/bearuang --skill bmad-editorial-review-prose-lincie
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: bmad-editorial-review-prose
Source: https://github.com/LinCie/bearuang/tree/main/.opencode/skills/bmad-editorial-review-prose
Command: npx skills add https://github.com/LinCie/bearuang --skill bmad-editorial-review-prose-lincie

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Unclear writing, grammar errors, and ambiguous phrasing impede reader comprehension, but manual copy-editing is slow and inconsistent. This Skill performs a disciplined editorial review of text and returns only genuine communication fixes, preserving the author's voice and ideas. ## Core Features & Use Cases - Minimal-intervention editing: Identifies only issues that impede comprehension, never rewriting for style preference or restructuring content. - Style guide override: Accepts an optional project style guide that overrides the default Microsoft Writing Style Guide baseline. - Reader-aware calibration: Adjusts review priorities for human readers (clarity, flow) or LLM consumers (unambiguous references, consistent terminology). - Use Case: Paste a draft documentation page and ask for a prose review; receive a deduplicated three-column table of original text, suggested revisions, and explanations, with code blocks and frontmatter automatically skipped. ## Quick Start Review this markdown draft 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?▼

Provide the text as the content input and request a prose review. The Skill analyzes style and tone, identifies communication issues that impede comprehension, and returns a three-column table of original text, revised text, and explanations.

How to apply a custom style guide during editorial review?▼

Pass your project style guide as the style_guide input alongside the content. It overrides the default Microsoft Writing Style Guide baseline and reader-type priorities, except the rule that content ideas are never changed.

Does the prose review change code blocks or frontmatter?▼

No, the review detects and skips code blocks, frontmatter, and structural markup automatically. Only prose sections are analyzed, and the existing document structure is always preserved.

What is the difference between humans and llm reader_type?▼

The reader_type input calibrates review priorities. The humans setting emphasizes 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 when the content is empty or contains fewer than three words, since meaningful editorial review requires a minimum amount of text. Provide at least three words of prose to proceed.

Will the review rewrite my text to a different tone?▼

No, the review applies minimal intervention and respects author voice. Intentional stylistic choices are preserved, uncertain fixes are phrased as queries, and ideas are never challenged, only clarified.