skills.rest
Markuson
MarkusonCOMMUNITY
Explore all skills by this author →
GitHub

bmad-editorial-review-prose

Review prose for clarity and comprehension using Microsoft Writing Style Guide principles.

Updated May 13, 2026
Search Tags:#writing#communication#clarity#prose#editorial#copy-editing
One-click install
npx skills add https://github.com/Markuson/ivo_corr --skill bmad-editorial-review-prose-markuson
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: bmad-editorial-review-prose
Source: https://github.com/Markuson/ivo_corr/tree/main/.agents/skills/bmad-editorial-review-prose
Command: npx skills add https://github.com/Markuson/ivo_corr --skill bmad-editorial-review-prose-markuson

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill addresses communication barriers in professional writing by identifying prose issues that impede comprehension, ensuring your text is precise and professional without altering your core message.

Core Features & Use Cases

  • Clinical Editorial Review: Applies Microsoft Writing Style Guide principles to identify genuine comprehension issues rather than stylistic preferences.
  • Context-Aware Calibration: Adjusts feedback based on whether the target audience is human or an LLM, ensuring optimal clarity for the intended reader.
  • Use Case: Use this when you need to refine technical documentation or clinical reports to ensure they are unambiguous, consistent, and easy to follow for your specific audience.

Quick Start

Provide the text you want reviewed and specify the reader type as humans or llm to receive a structured table of suggested 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 prose for clarity and comprehension issues?▼

Editorial review for clear communication applies Microsoft Writing Style Guide principles to identify comprehension barriers. It provides structured suggestions for minimal, non-intrusive edits while preserving the author's original intent.

What is the best way to copy-edit technical documentation for unambiguous readability?▼

The best way to copy-edit technical documentation is using a clinical editorial review that targets genuine comprehension issues rather than stylistic preferences. This ensures text remains precise, unambiguous, and consistent without altering the core message.

Can I optimize prose specifically for an LLM reader instead of a human audience?▼

Yes, you can optimize prose for an LLM reader by using context-aware calibration. This adjusts feedback to ensure optimal clarity and precision for either human readability or LLM-optimized comprehension based on your specified target audience.

How do I get started with an editorial review of my text?▼

To get started, provide the text-heavy input you want reviewed and specify the reader type as humans or llm. You will then receive a structured table of suggested improvements tailored to your chosen audience.

Does this editorial review alter my original writing style and core message?▼

No, the editorial review does not alter your core message or writing style. It suggests minimal, non-intrusive edits that preserve the author's original intent while resolving genuine communication barriers in professional writing.

Related Skills

Explore More Content & Communication Skills→
josemariafsjosemariafs
3

bmad-editorial-review-prose

Review Markdown and plain text for clarity and communication issues.

Community
Advanced
ether-moonether-moon

writing-clear-prose

Refine professional non-fiction prose for clarity, concision, and persuasiveness.

Community
Intermediate
Imad-OuteImad-Oute
2

mh-editorial-review-prose

Conduct clinical copy editing of text for clarity and comprehension.

Community
Advanced
CygnusfearCygnusfear
5

writing-clearly-and-concisely

Apply Strunk's writing rules to improve prose clarity and concision.

Community
Basic