bmad-editorial-review-prose

Review Markdown and plain text for clarity and communication issues.

3|2|Updated Mar 29, 2024
One-click install
npx skills add https://github.com/josemariafs/MVTools --skill bmad-editorial-review-prose-josemariafs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bmad-editorial-review-prose
Source: https://github.com/josemariafs/MVTools/tree/main/.cursor/skills/bmad-editorial-review-prose
Command: npx skills add https://github.com/josemariafs/MVTools --skill bmad-editorial-review-prose-josemariafs

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Review text for clarity and identify communication issues.

Core Features & Use Cases

  • Detections: Identify ambiguity, redundancy, jargon, and structure issues without altering content meaning.
  • Preservation of Voice: Maintains author voice unless a change improves clarity.
  • Guided Review: Provides a structured, stepwise set of recommendations suitable for editorial workflows.
  • Use Case: A technical report paragraph is refined for readability without changing technical conclusions.

Quick Start

Provide a paragraph for review and request a prose improvement.

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 markdown prose for clarity and editorial issues?

To review markdown prose for clarity, provide the text to the editorial review tool. It identifies ambiguity, redundancy, and jargon while preserving frontmatter and skipping code blocks, outputting fixes in a structured table.

Can I copy-edit technical documentation without altering the author's voice?

Yes, you can copy-edit technical documentation while preserving the author voice. The review process maintains the original tone unless a specific change directly improves clarity or resolves structural communication issues.

What is the best way to identify jargon and redundancy in plain text reports?

The best way to identify jargon and redundancy in plain text reports is using a structured stepwise critique. It highlights communication issues without altering content meaning, outputting recommended fixes by location in a three-column table.

Does the prose review process work with content that contains frontmatter?

Yes, the prose review process works with content containing frontmatter. It supports Markdown, plain text, and frontmatter formats, scanning the text while skipping code blocks to focus purely on editorial improvements.

What are the limitations of automated copy-editing for technical reports?

Automated copy-editing for technical reports focuses on readability without changing technical conclusions. It is limited to identifying ambiguity, redundancy, and structure issues, providing recommendations rather than directly rewriting the original content.

How do I get a structured critique of my writing's communication issues?

To get a structured critique of communication issues, submit your prose for editorial review. It generates a stepwise set of recommendations formatted as a three-column table detailing the issue, its location, and the suggested fix.