Skip to content
cccskills
FreePublished on GitHub

bmad-walkthrough

Guide a person through reviewing a commit, pull request, file, or directory. The skill generates and follows a BMad workflow to lead the review of the selected target.

OriginalShow the original description

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

See how to install

Good for

  • Reviewing a commit with guidance
  • Walking through a pull request
  • Reviewing a file or directory

Files included (8)

  • SKILL.md961 B
  • bmod.toml80 B
  • customize.toml1.1 KB
  • step-01-orientation.md691 B
  • step-02-narrative.md1.0 KB
  • step-03-walkthrough.md2.6 KB
  • templates/log-template.md1.4 KB
  • workflow.md3.7 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

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.

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

bmad

FreeSummary

Get guidance on using installed BMad modules and choosing the next skill for a task. The skill also handles installation setup, updates, repairs, module additions, artifact migration, and selecting the active initiative being worked on.

  • Choosing where to start or what to do next
  • Setting up or repairing a BMad installation
  • Adding modules or migrating project artifacts
bmad-code-org/BMAD-METHOD54.3KUpdated Oct 19, 2026

Revisit a recent answer, plan, draft, or decision using selected critique methods. The skill offers relevant approaches, explains what they reveal, and proposes improvements that are applied only after the user accepts them.

  • Examining assumptions in a plan
  • Reviewing a draft from several perspectives
  • Exploring failure risks before a launch
bmad-code-org/BMAD-METHOD54.3KUpdated Oct 19, 2026

Work with Mary, a business analyst persona, to research markets, examine competitors, and clarify requirements. Use evidence-based discussion to turn vague needs into concrete specifications that can guide the next steps of a project.

  • Researching a market before planning a project
  • Examining competitors to inform a business idea
  • Turning vague requests into concrete requirements
bmad-code-org/BMAD-METHOD54.3KUpdated Oct 19, 2026

Turn product requirements and user experience plans into technical architecture with Winston, a system architect persona. Discuss technology choices and their trade-offs, with an emphasis on established tools, developer productivity, and designs that can be implemented.

  • Turning product requirements into a technical design
  • Discussing trade-offs between technology choices
  • Reviewing architecture with developer productivity in mind
bmad-code-org/BMAD-METHOD54.3KUpdated Oct 19, 2026

bmad-agent-dev

FreeSummary

Implement approved development stories and code changes with Amelia, a senior software engineer persona. Follow a test-first process: write a failing test, make it pass, then improve the code while checking every acceptance criterion.

  • Implementing an approved development story
  • Making code changes with a test-first process
  • Checking implementation against acceptance criteria
bmad-code-org/BMAD-METHOD54.3KUpdated Oct 19, 2026

bmad-agent-pm

FreeSummary

Work with John, a product manager persona, to clarify requirements through user interviews and stakeholder alignment. Turn a product vision into a PRD, a product requirements document, and small, validated increments for development.

  • Turning a product idea into a PRD
  • Discovering requirements through user interviews
  • Aligning stakeholders on product requirements
bmad-code-org/BMAD-METHOD54.3KUpdated Oct 19, 2026

See all skills by bmad-code-org

Report a problem with this skill