bmad-walkthrough
SkillFiles & storagebmad-walkthrough is a skill that guides a human review of a commit, PR, file, or directory. When invoked by name, it lets your agent walk you through the review step by step. It is for anyone who wants a structured way to examine changes or files with an AI agent.
Use bmad-walkthrough in Claude, ChatGPT or Ahel Desktop
Free. Sign in, add bmad-walkthrough and connect your AI. About a minute.
Also: Claude Code · Cursor · Codex
Then ask your AI: use the bmad-walkthrough skill
Details
Instructions available. Your AI can read the instructions. Execution depends on the setup they require.
Account requirements not reviewed. Check the skill instructions before use; ahel provides instructions and does not run this skill.
No other account needed.
Have an AI agent that can load and run skills.
What your AI can do with it
- Guide a step by step review of a commit
- Guide a step by step review of a PR
- Guide a step by step review of a file
- Guide a step by step review of a directory
- Invoke the walkthrough by name
Getting started
- Have an AI agent that can load and run skills.
- Add the bmad-walkthrough skill to your agent's available skills.
- Invoke the skill by name when you want to review a commit, PR, file, or directory.
- Follow the agent's step by step guidance for the review.
What this skill tells your AI
The instructions your AI receives, as published by bmad-code-org/bmad-method in skills/bmad-walkthrough/SKILL.md and read by ahel’s review.
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}"
- On success, the command prints
read and followand an absolute path to a renderedworkflow.md. Read that file and follow it. - If the script is not found, BMad is not set up here. Offer to run the
bmadskill's setup, installingbmadfirst 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
uvbeing unavailable), report the command output and HALT. Do not run any workflow source directly.
Signals
- GitHub stars
- 54k
- Forks
- 6k
- Last commit
- Oct 2026
Questions
- What kinds of things can I review with this skill?
- You can review a commit, a PR, a file, or a directory. The skill guides you through the review step by step.
- How do I start the walkthrough?
- Invoke the skill by name. Your agent will then guide you through the review.
- Does this skill review code automatically?
- No. It guides a human review. The agent walks you through the review step by step.
- Can I use this skill with any AI agent?
- The skill works with an AI agent that can load and run skills. It is invoked by name.
Advanced
- Item type
- skill
- Key
bmad-walkthrough- Source
- github.com/bmad-code-org/bmad-method
github.com/bmad-code-org/bmad-method