bmad-editorial-review

Forwards legacy editorial review requests to the bmad-review structure and prose lenses.

52.5k|6.0k|Updated Apr 13, 2025
One-click install
npx skills add https://github.com/bmad-code-org/BMAD-METHOD --skill bmad-editorial-review
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bmad-editorial-review
Source: https://github.com/bmad-code-org/BMAD-METHOD/tree/main/src/core-skills/v6-shims/bmad-editorial-review
Command: npx skills add https://github.com/bmad-code-org/BMAD-METHOD --skill bmad-editorial-review

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill preserves backward compatibility for teams still invoking the deprecated bmad-editorial-review workflow, routing their requests and saved overrides into the current bmad-review skill without breaking existing configurations.

Core Features & Use Cases

  • Legacy Forwarding: Redirects editorial review invocations to bmad-review using its structure and prose lenses, running structure first so prose builds on structure findings.
  • Override Resolution: Resolves legacy customization fields (reader_type, style_guide, review_guidance, output_preferences, and more) from customize.toml and passes only non-empty values to bmad-review as pre-resolved settings.
  • Legacy Output Shape: Presents results in the original two-pass findings table format with purpose/audience context and a reduction summary when the structure pass ran.
  • Use Case: A team with an old bmad-editorial-review.toml override file upgrades BMad; their saved style guide and reader type settings still apply automatically when reviews run through the new bmad-review engine.

Quick Start

Invoke bmad-editorial-review on your document and it will forward the content to bmad-review with the structure and prose lenses while honoring your legacy overrides.

Frequently Asked Questions about bmad-editorial-review

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run an editorial review after bmad-editorial-review was deprecated?

Invoke the bmad-review skill directly with the structure and prose lenses, structure first. The deprecated bmad-editorial-review skill still works but simply forwards your request to bmad-review with those lenses applied.

What happens to my old bmad-editorial-review customization settings?

Legacy overrides in bmad-editorial-review.toml files still resolve through the shim's customize.toml. Non-empty values like reader_type and style_guide are passed to bmad-review as pre-resolved settings, while empty values fall through to bmad-review defaults.

Can I request only a structure or only a prose review?

Yes. If the caller asks for a structure-only or prose-only review, the shim forwards just that single lens to bmad-review instead of running both passes.

Where should new review customizations be configured?

New customization belongs in bmad-review's customize.toml, which documents every field. The bmad-editorial-review customize.toml exists only so old overrides keep resolving and contributes no defaults of its own.

What output format does the deprecated editorial review produce?

It presents the legacy two-pass findings table with columns Pass, Original Text, Revised Text, and Changes, preceded by the purpose and audience read. When the structure pass runs, a reduction summary appears below the table.