Skills › BMAD Method › bmad-walkthrough

bmad-walkthrough

skill · 14 lines · MIT · skills/bmad-walkthrough/SKILL.md

The facts

Its description

Guide a human review of a commit, PR, file, or directory. Use when invoked by name

The description the agent reads to decide when to use it.

From its settingsline 3

When it starts

It loads when the user invokes it by name: the description tells the agent to use it to guide a human review of a commit, PR, file, or directory, so it fires when someone asks for a named walkthrough rather than from ordinary topic talk.

Things a person might say (the model's guesses)

“run bmad-walkthrough on this PR”
“give me a bmad-walkthrough of this commit”
“do a bmad-walkthrough over the src/auth folder before I merge”

A model's summary of when it is used.

A model's reading

Runs scripts

scripts/render_skill.py

Scripts the text names. Found by matching words, so treat them as pointers.

Found by matching wordsline 9

What it leads to

calls bmad only if the render script is not found line 13
calls bmad-code-review when the user picks Formal review and the target is code step-03-walkthrough.md, line 50
calls bmad-review when the user picks the Formal review move step-03-walkthrough.md, line 49

Other skills this one hands off to, calls, requires or offers instead, as a model read them.

A model's reading

What leads to it

bmad-build hands off to this after the workflow completes bmad-build/step-05-present.md, line 33

Other skills that hand off to this one, call it, require it or offer it instead, as a model read them.

A model's reading

Licence

MIT, from LICENSE

The terms its author shares it under, which let it be shown here.

From the repositorylicence text

Other files in this skill (7) Close

The text

Runs code Names a skill

Open on GitHub

Most marks come from matching words in the file, so treat them as pointers.

1---

2name: bmad-walkthrough

3description: 'Guide a human review of a commit, PR, file, or directory. Use when invoked by name'

4---

6Run 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:

8```bash

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

10```

12- The command prints the skill's workflow: follow it. `HALT: <reason>`: report the reason and stop.

13- 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.

14- On any other failure (including `uv` being unavailable), report the command output and HALT. Do not run any workflow source directly.

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:

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.

Raw lines 1 to 14

Runs code scripts/render_skill.py :9

Names a skill bmad :13

From bmad-code-org/BMAD-METHOD at bd70c64, 2026-10-31. Skills read by DeepSeek V4.1 Flash on 2026-11-04. Summary and techniques by Claude Opus 5.5 on 2026-11-06.