Skip to main content
affpapa.org
RU EN
skill Claude Code CX Codex Cursor GitHub Copilot

bmad-walkthrough — Claude Code skill: review and install

This skill guides a human review of a commit, PR, file, or directory. Use it when a project review should follow the workflow printed by the skill.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓ 
npx skills add bmad-code-org/BMAD-METHOD --skill bmad-walkthrough -a claude-code
Open on GitHub

What bmad-walkthrough does

bmad-walkthrough guides a human review of a commit, PR, file, or directory. When invoked, it runs render_skill.py once through uv, passing the project root and the skill directory. The script prints the workflow to follow.

If the script cannot be found, the skill offers to set up bmad and then retry the command. Other failures, including a missing uv executable, stop the process and report the command output. Check that uv and _bmad/scripts/render_skill.py are available before invoking it.

What it helps with

  • review a commit by following a defined workflow
  • walk through a pull request
  • inspect a single file
  • review a project directory

Example prompts for the agent

  • Run `bmad-walkthrough` to review the latest commit.
  • Invoke `bmad-walkthrough` for a human review of this PR.
  • Use `bmad-walkthrough` to inspect the `src/` directory.

How to install bmad-walkthrough

1Skills CLI (Vercel)

npx skills add bmad-code-org/BMAD-METHOD --skill bmad-walkthrough -a claude-code

2Manually: put the files in place

~/.claude/skills/bmad-walkthrough/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/bmad-walkthrough/

From the same set25

The whole set →
bmad bmad-code-org Coordinates BMad Method modules, recommends the next skill, and tracks project initiatives. Useful when setting up or repairing your workflow. Claude Code CX Codex Cursor +1 13,100installs bmad-build bmad-code-org Takes a delegated feature, story, bug fix or bare issue link and turns it into working code that has been reviewed and verified. Needs BMad set up in the project. Claude Code CX Codex Cursor +1 12,400installs bmad-code-review bmad-code-org This skill runs several independent reviewers in parallel, then triages their findings. Useful when you want changes checked before a merge. Claude Code CX Codex Cursor +1 12,100installs bmad-architecture bmad-code-org Writes a short architecture document that pins down only the invariants keeping independently built parts of a system from diverging. Claude Code CX Codex Cursor +1 11,800installs bmad-agent-pm bmad-code-org Activates John, a product manager persona for PRD creation and requirements discovery. It breaks down product ideas into deliverable tickets. Claude Code CX Codex Cursor +1 11,800installs bmad-agent-architect bmad-code-org This skill turns ticket requirements into technical architecture with explicit trade-offs. Use it when you want to work with Winston as the architect. Claude Code CX Codex Cursor +1 11,800installs bmad-brainstorming bmad-code-org The skill runs a brainstorming session: the agent asks one question at a time, rotates creative techniques and logs ideas to a memlog. Useful when you want more options than you'd get alone. Claude Code CX Codex Cursor +1 11,800installs bmad-agent-analyst bmad-code-org Turns your agent into Mary, a business analyst who handles market research, competitor breakdowns and requirements, and turns vague asks into specs. Claude Code CX Codex Cursor +1 11,700installs

Similar

frontend-patterns affaan-m A skill for React and Next.js work: component patterns, state, data fetching, and render performance. Use it when building or reviewing UI. Claude Code CX Codex Cursor +1 5,900installs durable-objects cloudflare This skill helps build, debug, and review Cloudflare Durable Objects for state, coordination, and persistent connections. Claude Code CX Codex Cursor +1 109,700installs coding-standards affaan-m Baseline cross-project coding conventions for naming, immutability, and clean code principles. Useful for code reviews and refactoring. Claude Code CX Codex Cursor +1 5,600installs api-design affaan-m Provides REST API design standards covering resource naming, status codes, pagination, and error payloads. Use it when creating or auditing API contracts. Claude Code CX Codex Cursor +1 5,500installs laravel-security affaan-m This skill reviews Laravel authentication, Eloquent safety, CSRF, XSS, APIs, and production settings. Use it for security reviews or deployment checks. Claude Code CX Codex Cursor +1 5,400installs improve-codebase-architecture Matt Pocock This skill scans a codebase for architectural friction, then builds a visual HTML report with refactoring candidates. Use it before a deeper architecture review. Claude Code 1,163,035installs tdd Matt Pocock Guides the red-green TDD loop: ensures tests are written first, keep them at public interfaces, and avoid coupling to implementation details. Claude Code 1,141,062installs triage Matt Pocock This skill moves issues and external PRs through triage states, verification, and agent briefs. It fits maintainers managing an issue queue. Claude Code 990,453installs

Questions about bmad-walkthrough

How do I install bmad-walkthrough in Claude Code?

Run these steps in order: npx skills add bmad-code-org/BMAD-METHOD --skill bmad-walkthrough -a claude-code, then run the same command again: npx skills add bmad-code-org/BMAD-METHOD --skill bmad-walkthrough -a claude-code. The skill file will be available at ~/.claude/skills/bmad-walkthrough/SKILL.md.

What does bmad-walkthrough do?

It guides a human review of a commit, PR, file, or directory. It prints a review workflow through render_skill.py, which the reviewer then follows.

What does bmad-walkthrough need to run?

The project needs uv and _bmad/scripts/render_skill.py. If uv is unavailable or another error occurs, the process stops and reports the command output.

Source text

SKILL.md · MIT 
---
name: bmad-walkthrough
description: 'Guide a human review of a commit, PR, file, or directory. Use when invoked by name'
---

Run the following command exactly once without changing the current working directory. Replace `{project-root}` with the absolute path to the project root and `{skill-root}` with the absolute path to this skill's directory:

```bash
uv run --no-cache "{project-root}/_bmad/scripts/render_skill.py" --project-root "{project-root}" --skill "{skill-root}"
```

- The command prints the skill's workflow: follow it. `HALT: <reason>`: report the reason and stop.
- If the script is not found, BMad is not set up here. Offer to run the `bmad` skill's setup, installing `bmad` first if you do not have it (`npx skills add bmad-code-org/BMAD-METHOD --skill bmad`), then run the command above once more.
- On any other failure (including `uv` being unavailable), report the command output and HALT. Do not run any workflow source directly.

© bmad-code-org · MIT · bmad-code-org/BMAD-METHOD

See also

Project sponsors

Companies that keep this analytics open
Gold sponsor
Nutra.Club

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor