# bmad-review

> Claude/Codex skill by [@bmad-code-org](https://omgskills.com/library/bmad-code-org/index.md) · 54k stars · Updated 2026-10-18

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.

Tags: agile, ai, context-engineering, sdlc, spec-driven-development

## Install

```sh
git clone https://github.com/bmad-code-org/BMAD-METHOD /tmp/BMAD-METHOD && ln -s /tmp/BMAD-METHOD/skills/bmad-review ~/.claude/skills/bmad-review
```

## From README

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\].

## Links

- HTML page: https://omgskills.com/skills/bmad-code-org/bmad-method/bmad-review/
- GitHub: https://github.com/bmad-code-org/BMAD-METHOD
- Author: [@bmad-code-org](https://omgskills.com/library/bmad-code-org/index.md)

## More from this repo

- [bmad](https://omgskills.com/skills/bmad-code-org/bmad-method/bmad/index.md) — Answers BMad questions and recommends the next skill from what is installed.
   - [@bmad-code-org](https://omgskills.com/library/bmad-code-org/index.md) · 54k stars
- [bmad-advanced-elicitation](https://omgskills.com/skills/bmad-code-org/bmad-method/bmad-advanced-elicitation/index.md) — Push the LLM to reconsider, refine, and improve its recent output.
   - [@bmad-code-org](https://omgskills.com/library/bmad-code-org/index.md) · 54k stars
- [bmad-agent-analyst](https://omgskills.com/skills/bmad-code-org/bmad-method/bmad-agent-analyst/index.md) — Business analyst for market research, competitive analysis, and requirements.
   - [@bmad-code-org](https://omgskills.com/library/bmad-code-org/index.md) · 54k stars