skills.rest
tabesink
tabesinkCOMMUNITY
Explore all skills by this author →
GitHub

bmad-editorial-review-prose

Review prose for comprehension issues and produce a three-column revision table.

Updated May 3, 2026
Search Tags:#clarity#prose#editorial review#copyediting#text revision#communication issues#writing style guide
One-click install
npx skills add https://github.com/tabesink/deepdoc-agent --skill bmad-editorial-review-prose-tabesink
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: bmad-editorial-review-prose
Source: https://github.com/tabesink/deepdoc-agent/tree/main/.cursor/skills/bmad-editorial-review-prose
Command: npx skills add https://github.com/tabesink/deepdoc-agent --skill bmad-editorial-review-prose-tabesink

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you identify communication problems in text that can block comprehension, then proposes minimal, professional revisions to improve clarity without changing the author’s intent.

Core Features & Use Cases

  • Prose communication review: Flags issues that impede understanding and suggests precise fixes.
  • Minimal-intervention editing: Applies the smallest change needed for clarity while preserving structure and author voice.
  • Deduplicated, structured output: Returns results as a three-column table listing the original text, revised text, and change rationale.
  • Skips non-relevant content: Detects and avoids code blocks, frontmatter, and structural markup.
  • Uncertain fixes as questions: Uses “Consider: …?” when a definitive change isn’t certain.

Quick Start

Ask the Skill to review the text you provide for clarity issues and return a three-column table of recommended revisions.

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 to identify communication issues that impede comprehension?▼

Prose is reviewed to flag communication problems and provide minimal revised wording. It outputs a three-column table listing the original text, revised text, and change rationale to resolve comprehension issues.

What is the best way to copyedit markdown text without altering code blocks?▼

To copyedit markdown without altering code blocks, the review detects and skips code blocks, frontmatter, and structural markup. Only the surrounding prose is evaluated for clarity and minimal revisions.

Can I use a writing style guide to ensure minimal-intervention editing?▼

Yes, minimal-intervention editing applies the smallest change needed for clarity while preserving structure and author voice. Uncertain fixes are presented as questions rather than definitive changes.

Does the text revision process work with plain text and text-heavy XML?▼

Yes, text revision works with markdown, plain text, and text-heavy XML. It validates inputs and halts on too-short content or invalid reader_type, skipping structural markup to focus on prose.

What are the limitations when providing input for an editorial review?▼

Editorial review limitations include halting on too-short content or invalid reader_type inputs. It also skips non-relevant content like code blocks, frontmatter, and structural markup during the review process.

Related Skills

Explore More Content & Communication Skills→
enigmaicon-engenigmaicon-eng
1

bmad-editorial-review-prose

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

Community
Intermediate
Cbanzaime23Cbanzaime23

bmad-editorial-review-prose

Review prose and output a three-column table of edits.

Community
Advanced
PalomigPalomig

docs-review

Review documentation changes against a specified writing style guide.

Community
Intermediate
luispabonluispabon
6

copy-polisher

Correct grammar, punctuation, and clarity issues while preserving the author's original voice.

Community
Intermediate