bmad-review

Reviews diffs, pull requests, and documents through configurable lenses and reports triaged findings.

Updated Mar 1, 2026
One-click install
npx skills add https://github.com/Hexalith/Hexalith.Parties --skill bmad-review-hexalith
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bmad-review
Source: https://github.com/Hexalith/Hexalith.Parties/tree/main/.agents/skills/bmad-review
Command: npx skills add https://github.com/Hexalith/Hexalith.Parties --skill bmad-review-hexalith

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve? Reviewing code changes and documents consistently is hard: reviewers miss edge cases, skip verification checks, and apply inconsistent standards. This Skill runs structured review passes — adversarial critique, edge-case hunting, verification-gap analysis, and editorial structure/prose review — and reports findings in one canonical shape. ## Core Features & Use Cases - Multi-lens review: Runs adversarial, edge-case-hunter, verification-gap, structure, and prose lenses, each with its own method and findings shape, selected automatically by content type or explicitly by the caller. - Customizable workflow: A customize.toml file plus team/user override files control lens sets, style guides, review guidance, output format, and report destination. - Parallel subagent execution: Independent lenses run simultaneously as subagents when available, with dependent lenses (e.g. prose after structure) chained on prior findings. - Use Case: Ask for a review of a pull request diff; the Skill stages the diff, runs the applicable lenses, and returns a JSON findings array plus a markdown report grouped by lens with concrete fixes. ## Quick Start Ask the assistant to review the current branch diff or a specific file, for example: review the uncommitted changes in this repository.

Frequently Asked Questions about bmad-review

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

FAQPage Schema
How do I review a pull request or diff with multiple review lenses?

Ask for a review of the diff, branch, or uncommitted changes. The Skill stages the diff to a temp file, selects applicable lenses based on content type, runs them, and returns findings as a JSON array plus a markdown report grouped by lens.

What review lenses are available for code and document review?

Five shipped lenses: adversarial (finds at least ten issues), edge-case-hunter (traces unhandled paths), verification-gap (checks test coverage of changed behavior), structure (document organization), and prose (copy-editing). Overrides can add or replace lenses.

Can I customize the review lenses and output format?

Yes. The customize.toml workflow table controls lenses, output format (json, markdown, or both), report path, style guide, and review guidance. Team and user override TOML files merge per BMad structural rules without editing the shipped file.

Does the review skill run lenses in parallel?

When subagents are available, every independent lens is launched simultaneously, each receiving the staged content path and returning only findings. Dependent lenses declared with an after field run once their target lens completes.

When should I not trigger an automated review?

Only invoke it when the user explicitly asks for a review of a diff, pull request, or artifact. A request to act on earlier review feedback is a change request, not a review, and the Skill must never run uninvited on edits just made.