# Bmad Review

Runs one or more installed review lenses, adversarial critique, edge cases...

- Repository: https://github.com/bmad-code-org/BMAD-METHOD (54863 stars)
- Category: Git and review
- License: see repository
- Last updated: 2026-11-01
- Runs scripts: yes, review before use

## Install

Claude Code: `npx skills add bmad-code-org/BMAD-METHOD --skill bmad-review -g -a claude-code -y`
Codex: `npx skills add bmad-code-org/BMAD-METHOD --skill bmad-review -g -a codex -y`
Cursor: `npx skills add bmad-code-org/BMAD-METHOD --skill bmad-review -g -a cursor -y`
Gemini CLI: `npx skills add bmad-code-org/BMAD-METHOD --skill bmad-review -g -a gemini-cli -y`

## Description

Runs one or more installed review lenses, adversarial critique, edge cases, verification gaps, structure, prose, and reports triaged findings. Use when, and only when, the user asks you to review a diff, a pull request, or an artifact, code or documents, one or many, and actually says "review"; an explicit skill:bmad-review directive from another skill counts as that ask. A request to act on feedback from an earlier review is a change, not a review. Never invoke this uninvited, including on edits you just made.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# BMad Review

Review content through lenses, each a distinct method and stance, and report findings in one canonical shape. Report what is real, never pad to look thorough. Each lens sets its own stance toward the content and toward zero findings: for most an empty result is valid; the adversarial lens requires at least ten concrete findings and treats an empty list as a signal to re-check; the editorial lenses hold content sacrosanct and critique only how it is organized and expressed.

The lens set is whatever `{workflow.lenses}` resolves to, not a fixed list, overrides add lenses and replace shipped ones. Never claim a capability from this file; read the resolved lenses and work from those.

## Inputs

- **content**, what to review: a diff, branch, uncommitted changes, file, ticket (initiative, epic, story, spike, bug), or any document. Args: `[path]`.
- **lenses** (optional), one or more lens codes or names, however the caller expresses them: a spoken request, or a directive of the form `skill:bmad-review lenses=<code>[,<code>...]` (the form bmm's `doc_standards` uses). Default: every applicable lens (a full review).
- **also_consider** (optional), areas to keep in mind alongside each lens's normal analysis.
- **claims** (optional), the change's own narrative: the commit messages it covers, or whatever description of it the caller supplied. Goes to the edge-case lens alone.
- **pre-resolved customization** (optional), `[workflow]` field values supplied by a forwarding caller. See Execution step 1.

## Conventions

The rest: https://github.com/bmad-code-org/BMAD-METHOD/blob/HEAD/skills/bmad-review/SKILL.md