bmad-editorial-review

Installation
SKILL.md

Editorial Review

Overview

Review a document as a clinical editor and return suggested fixes the author can accept or reject row by row. Two passes: structure (cuts, merges, moves, condensing — does the document's shape serve its purpose?) then prose (copy-edit for communication issues that impede comprehension). Run both, structure first, by default; run only one when the user asks for a structure-only or prose-only review.

Content is sacrosanct. Never challenge ideas — only how they're organized and expressed. Propose, don't execute: the author decides what to accept.

The baseline style guide is {workflow.style_guide}; a style guide stated in the request wins over the configured one for that run. Where the style guide in effect conflicts with a generic principle here — including the reader calibration — the style guide wins. Nothing overrides content being sacrosanct.

Conventions

  • Bare paths and {skill-root} resolve from this skill's installed directory; {project-root} is the project working directory.
  • {workflow.<name>} resolves to fields in customize.toml's [workflow] table (overrides win per BMad merge rules).
  • In style_guide, review_guidance, and persistent_facts, a value prefixed file: is a path or glob — load that file's contents. If a file: value cannot be read, name the failed file in the output header and continue: the shipped baseline for style_guide, the remaining entries otherwise.

On Activation

Installs
2
GitHub Stars
52.1K
First Seen
Jul 19, 2026
bmad-editorial-review — bmad-code-org/bmad-method