bmad-editorial-review-prose

Review prose for comprehension issues and output a three-column correction table.

2|Updated Apr 2, 2026

Search Tags:#markdown #prose #deduplication #editorial review #copyediting #communication clarity #table output

Ready to run

npx skills add https://github.com/cassioalexandre/agf --skill bmad-editorial-review-prose-cassioalexandre

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: bmad-editorial-review-prose
Source: https://github.com/cassioalexandre/agf/tree/main/_bmad/core/bmad-editorial-review-prose
Command: npx skills add https://github.com/cassioalexandre/agf --skill bmad-editorial-review-prose-cassioalexandre

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill identifies communication problems in user-provided text that impede comprehension, then proposes minimal, clinical copy edits without changing the author’s ideas.

Core Features & Use Cases

Communication-focused review: Flags clarity issues that obstruct understanding, not stylistic preference changes.
Minimal, structure-preserving fixes: Suggests the smallest revision that improves comprehension while preserving existing structure.
Markup-aware processing: Skips code blocks, frontmatter, and structural markup to avoid unsafe or irrelevant edits.
Deduplicated reporting: Merges repeated issues into single entries and lists all affected locations in one row.
Structured output for action: Returns a three-column table with original text, revised text (or a clarifying query), and change rationale.

Quick Start

Ask the editor to review the text you paste as "content" and return a three-column table of only the comprehension-impairing issues it finds.

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 get a copyediting review for markdown prose without altering my code blocks?▼

Editorial review for markdown safely skips code blocks, frontmatter, and structural markup, targeting only text passages that impede comprehension. It outputs a table of original text, minimal revisions, and change explanations while preserving your document's structure.

What is the best way to identify and deduplicate communication clarity issues in plain text?▼

Identifying and deduplicating communication clarity issues involves merging repeated problems into single entries and listing all affected locations. The review proposes minimal clinical edits and outputs a structured three-column table with rationale for each change.

Can I use this prose review tool on XML-like text and frontmatter without breaking the structure?▼

Yes, you can review XML-like text and markdown safely. The tool is markup-aware, actively skipping frontmatter, code blocks, and structural markup to ensure revisions are targeted and do not break your existing document structure.

How to perform an editorial review that only suggests minimal edits for comprehension?▼

Performing an editorial review with minimal edits flags only clarity issues that obstruct understanding rather than stylistic preferences. It suggests the smallest possible revisions to improve comprehension, preserving the author's original ideas and document structure.

Does the copyediting output include explanations for each text revision?▼

Yes, the copyediting output includes explanations for each text revision. The tool generates a structured three-column table containing the original passage, the revised text or a clarifying query, and the specific rationale explaining why the change improves comprehension.